基于Visual studio创建API项目

news2024/11/22 21:00:16

API（英文全称：Application Programming Interface,中文：应用程序编程接口）
为什么要
通过API接口可以与其他软件实现数据相互通信，API这项技术能够提高开发效率。

本文是基于vs2017 .net平台搭建API。希望可以帮助到学习.net API开发的朋友们。

本文创建的API与RESTful API 是类似的。

→→→→→多了不说，少了不唠。进入正题→→→→

创建API项目

文件–新建–项目打开【添加新项目】窗口，然后选择【ASP.NET Web应用程序（.NET Framework）】，点击确定，如下所示：
在这里插入图片描述
选择空项目，添加文件夹和核心引用：选中【Web API】,点击确定

创建API完成，目录如下：

Models、views和Controllers存放三层架构内容（views文件夹在添加文件夹和核心引用时没有选择MVC选项，所以没有创建）
App_Start中WebApiConfig.cs是存放API路由配置的文件

现在创建API 类文件，在Controllers文件夹右键，新建API控制类，创建UserController类。如图：
在这里插入图片描述
继承ApiController，如图：

讲解：继承ApiController后会实现四种请求方式（GET， PUT， POST， DELETE），按照下列方式映射为 CURD（数据库的增删改查）操作：

1、POST 用于在服务端新建资源，在指定的URL上创建一个新的对象，将新资源的地址作为响应消息返回；
2、PUT 利用URL 请求用于更新服务端的资源，如果服务端允许，PUT 也可以用于新建一个资源；
3、GET 通过 URL获取服务端资源，进行资源返回
4、DELETE 利用URL删除指定的资源。

做个小例子

在Model中创建一个User类

namespace APITool.Models
{
    public class User
    {
        public int Id { get; set; }

        public string Password { get; set; }

        public string UserName { get; set; }

        public string NickName { get; set; }

        public DateTime LoginTime { get; set; }
    }
}

连接数据库，由于代码量较多文章分两部分写（DataHelper类正在整理请稍后。。。。。）

SQL Server数据库连接信息：

<connectionStrings>
    <add name="APITool.Properties.Settings.SqlServerConnection" connectionString="Data Source=localhsot;Initial Catalog=test;Persist Security Info=True;User ID=sa;Password=sa"
      providerName="System.Data.SqlClient" />
  </connectionStrings>

Mysql数据库连接信息：

GET方式

SqlHelper sqlHelper = new SqlHelper();

        // GET api/<controller>
        public IHttpActionResult Get()
        {

            DataHelper dataHelper = new DataHelper();//数据库操作类
            DataSet dataSet =  dataHelper.GetDataSet(sqlHelper.USERSQL);//连接数据库并返回dataset集合

            List<User> userList = new List<User>();
			//处理集合数据并返回
            foreach (DataRow row in dataSet.Tables[0].Rows)
            {
                User user = new User();
                foreach (var prop in user.GetType().GetProperties())
                {
                    if (!row.IsNull(prop.Name))
                    {
                        prop.SetValue(user, row[prop.Name], null);
                    }
                }

                userList.Add(user);
            }

            return Ok(userList);
        }

postmain请求：
![在这里插入图片描述](https://img-blog.csdnimg.cn/82639fdafe5746f988442734c4a62d1f.png

带参数Get请求

// GET api/<controller>/5 或者api/<controller>?Id=1
        public List<User> Get(int id)
        {
            List < User > userList = new List<User>();
            DataHelper dataHelper = new DataHelper();//数据库操作类
			
			//sql参数
            DbParameter[] dbParameters = {
                new SqlParameter("Id",SqlDbType.Int){Value = id}
            };
			//连接数据库并返回DataTable 集合
            DataTable dataTable = dataHelper.GetDataSet(sqlHelper.USERWHERESQL, dbParameters);
			//处理集合数据并返回
            foreach (DataRow row in dataTable.Rows)
            {
                User user = new User();
                foreach (var prop in user.GetType().GetProperties())
                {
                    if (!row.IsNull(prop.Name))
                    {
                        prop.SetValue(user, row[prop.Name], null);
                    }
                }

                userList.Add(user);
            }

            return userList;
        }