DartVM服务器开发(第二十二天)--RestfulApi封装

上一篇,我们讲解了如何使用jaguar_serializer,今天,我们来学习一下如何通过该package,并结合之前的东西,封装起RestfulApi,该封装同样也适合Flutter,dart web

阅读该文章之前,我会默认的认为你已经看过我之前的文章,并知道如何使用数据库,开启服务器等!

图片来自网络.jpg

1.定义规范

  • 资源 使用JSON的形式表现
  • 资源格式 code 表示状态,0表示处理成功,-1表示处理失败 msg 表示消息,对客户端需要说明的一些信息,如:成功,请求方法不允许data表示数据,返回客户端的数据
  • 接口 get获取资源,查询资源 post新建资源,更新资源,查询资源 put更新资源 delete删除资源
  • URI 请求的地址可以附带id等,例如: Get http://localhost:8080/user/123 查询id为123的用户,Get http://localhost/user 查询所有用户, Post http://localhost:8080/user/123 修改id为123的的用户等

2. 定义Restful

我们新建一个Restful文件,输入下面代码

class Restful {
  int code;
  String msg;
  Object data;
}

然后导入jaguar_serializer包,添加下面代码

@GenSerializer()
class RestfulSerializer extends Serializer<Restful> with _$RestfulSerializer {}

运行命令pub run build_runner build,完后继续添加

part 'Restful.jser.dart';

ok,我们已经准备好Restful,那怎么把数据放到data里面呢 我们先来创建一个user.dart文件,创建一个用户模型,

class User {
  String id;
  String username;
  String password;
  int role;
  String phoneNumber;
  int sex;
}

与数据库进行关联

import 'package:jaguar_orm/jaguar_orm.dart';
import 'dart:async';
part 'user.jorm.dart';
class User {
  @PrimaryKey()
  String id;
  String username;
  String password;
  int role;
  @Column(length: 11)
  String phoneNumber;
  int sex;
  static const String tableName='_user';
  @override
    String toString()=> 'User(id:$id,username:$username,password:$password,role:$role,phoneNumber:$phoneNumber,sex:$sex)';
}
@GenBean()
class UserBean extends Bean<User> with _UserBean {
  UserBean(Adapter adapter) : super(adapter);
  @override
  String get tableName => User.tableName;
}

创建一个serializer.dart文件,用于存放所有json_serializer工具文件,添加下面代码

import 'package:jaguar_serializer/jaguar_serializer.dart';
import 'user.dart';
part 'serializer.jser.dart';
@GenSerializer()
class UserSerializer extends Serializer<User> with _$UserSerializer {
}

运行pub run build_runner build命令 下面是打印一个通过数据库查询id为2的restful api返回数据

import 'package:jaguar_query_postgres/jaguar_query_postgres.dart';
import 'package:TestDB/user.dart';
import 'package:TestDB/Restful.dart';
import 'package:TestDB/serializer.dart';
import 'dart:convert';
final PgAdapter pgAdapter =
    new PgAdapter('postgres', username: 'postgres', password: '123456');

main() async {
  await pgAdapter.connect();
  Restful restful = new Restful()
    ..code = 0
    ..msg = 'success'
    ..data = new UserSerializer().toMap((await new UserBean(pgAdapter).find("2")));
  print(json.encode(new RestfulSerializer().toMap(restful)));
}

我们可以简单的知道,一个模型转换为json数据需要经过两步操作

  • 模型转换为Map
  • map经过 json.encode 编码为字符串

相反的,json数据转换为模型也是两步

  • 字符串经过json.decode译码为map
  • map转换为模型 所以,我们可以结合jaguar_serializer封装一下Restful,封装如下
import 'dart:convert';
import 'package:jaguar_serializer/jaguar_serializer.dart';
part 'Restful.jser.dart';
RestfulSerializer serializer = new RestfulSerializer();
class Restful {
  int code;
  String msg;
  Object data;
  Restful();
  Map toMap([Serializer dataSerializer]) {
    if(dataSerializer==null){
      return serializer.toMap(this);
    }
    if (data is List) {
      List list =data;
      if(list.length!=0&& list[0] is Map){
      }else if(list.length!=0){
      data = dataSerializer.toList(data);
      }
    } else if (data is Map) {
    } else {
      data = dataSerializer.toMap(data);
    }
    return serializer.toMap(this);
  }

  String toJson([Serializer dataSerializer]) {
    return json.encode(toMap(dataSerializer));
  }

  factory Restful.fromMap(Map<String,dynamic> map, [Serializer dataSerializer]) {
    Restful api = serializer.fromMap(map);

    if(dataSerializer==null){
      return api;
    }
    if (api.data is List) {
       List<Map<dynamic,dynamic>> data=(api.data as List<dynamic>).map((d)=>d as Map<dynamic,dynamic>).toList();
      api.data = dataSerializer.fromList(data);
    } else if (api.data == null) {
    } else {
      api.data = dataSerializer.fromMap(api.data);
    }
    return api;
  }

  factory Restful.fromJson(String Json, [Serializer dataSerializer]) {
    return new Restful.fromMap(json.decode(Json),dataSerializer);
  }

  T fromJsonToData<T>(String Json,Serializer dataSerializer) {
    Restful api = serializer.fromMap(json.decode(Json));
    if (api.data is List) {
      // throw ArgumentError('data is List');
      return null;
    } else if (api.data == null) {
      return null;
    } else {
      return dataSerializer.fromMap(api.data);
    }
  }

  List<T> fromJsonToListData<T>(String Json, [Serializer dataSerializer]) {
    Restful restful = new Restful.fromJson(Json, dataSerializer);
    if (restful.data is List) {
      if(dataSerializer==null){
      return restful.data;
    }
      return restful.data;
    } else if (restful.data == null) {
      return null;
    } else {
      return null;
    }
  }
}
@GenSerializer()
class RestfulSerializer extends Serializer<Restful> with _$RestfulSerializer {}

上面主要有6个方法

  • toMap([Serializer dataSerializer])Restful转换为map,传入的是data对应的类型序列化工具[]表示非必填,如果data是基本类型,可不填
  • toJson([Serializer dataSerializer])Restful转换为字符串
  • Restful.fromMap(Map<String,dynamic> map, [Serializer dataSerializer])map转换为Restful
  • Restful.fromJson(String Json, [Serializer dataSerializer])字符串转换为Restful
  • fromJsonToData<T>(String Json,Serializer dataSerializer)字符串直接转换为data(T为泛型)
  • fromJsonToListData<T>(String Json, [Serializer dataSerializer])字符串直接转换为List<T>

3.定制接口

工具已经有了,数据也有了,那么我们现在就开始着手写接口了 main.dart

import 'package:jaguar_query_postgres/jaguar_query_postgres.dart';
import 'package:jaguar/jaguar.dart';
import 'package:jaguar_reflect/jaguar_reflect.dart';
import 'package:TestDB/UserController.dart';
final PgAdapter pgAdapter =
    new PgAdapter('postgres', username: 'postgres', password: '123456');

main() async {
  await pgAdapter.connect();
  new Jaguar( port: 1000)
  ..add(reflect(new UserController(pgAdapter)))
  ..serve();
}

UserController.dart

import 'package:jaguar/jaguar.dart';
import 'package:jaguar_orm/jaguar_orm.dart';
import 'serializer.dart';
import 'Restful.dart';
import 'user.dart';
 @Controller(path: '/user')
 class UserController {
   final UserBean userBean;
   UserController(Adapter adapter):userBean=new UserBean(adapter);
   @Get( path: '/:id')
    user(Context ctx) async{
      String id=ctx.pathParams['id'];
      Restful restful=new Restful()
      ..code=0
      ..msg='success'
      ..data=await userBean.find(id);
      return Response.json( restful.toMap(new  UserSerializer()));
   }
 }

我们来请求一下数据看看http://localhost:1000/user/1

user.png

可以看到,我们成功的在数据库中查找到一条记录,然后以json的形式传递给客户端 下面就是写其他的增删查改接口了

import 'package:jaguar/jaguar.dart';
import 'package:jaguar_orm/jaguar_orm.dart';
import 'serializer.dart';
import 'Restful.dart';
import 'user.dart';
 @Controller(path: '/user')
 class UserController {
   final UserBean userBean;

   UserController(Adapter adapter):userBean=new UserBean(adapter);
   
   @Get( path: '/:id')
    user(Context ctx) async{
      String id=ctx.pathParams['id'];
      Restful restful=new Restful()
      ..code=0
      ..msg='success'
      ..data=await userBean.find(id);
      return Response.json( restful.toMap(new  UserSerializer()));
   }

   @Post(path: '/:id')
   userEdit(Context ctx) async{
     String id=ctx.pathParams['id'];
     User user=await ctx.bodyAsJson(convert: new UserSerializer().fromMap);
     user.id=id;
     await userBean.update(user);
     return Response.json((new Restful()
     ..code=0
     ..msg='ok').toMap());
   }

    @Put(path: '/')
    userAdd(Context ctx) async{
     User user=await ctx.bodyAsJson(convert: new UserSerializer().fromMap);
      await userBean.insert(user);
      return Response.json((new Restful()
     ..code=0
     ..msg='ok').toMap());
    }

    @Delete(path: '/:id')
    userDelete(Context ctx) async{
     String id=ctx.pathParams['id'];
      await userBean.remove(id);
      return Response.json((new Restful()
     ..code=0
     ..msg='ok').toMap());
    }
 }

ok,上面就是今天的全部内容,我们明天见!

如果想继续学习DartVM服务器开发,请关注我,学习更多骚操作!

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏nnngu

04 Spring的@Autowired注解、@Resource注解、@Service注解

什么是注解 传统的Spring做法是使用.xml文件来对bean进行注入或者是配置aop、事务,这么做有两个缺点: 1、如果所有的内容都配置在.xml文件中,那...

45240
来自专栏cloudskyme

jbpm5.1介绍(6)

Junit测试的mini流程helloworld 这是一个在demo中使用的Script Task做的简单示例,在执行到这个任务结点的时候自动输出"hello...

36970
来自专栏码匠的流水账

使用proguard混淆springboot代码

本文的proguard配置仅仅是根据自身工程的情况来量身定做的,不是通用的,具体的场景还需要根据具体情况对proguard参数进行调整。

60210
来自专栏walterlv - 吕毅的博客

Introducing MSTestEnhancer to make unit test result easy to read

发布于 2018-03-05 06:21 更新于 2018-08...

9010
来自专栏小筱月

spring+springMVC 整合 MongoDB 实现注册登录

发现一入手 MongoDB,便无法脱离,简要说一下,MongoDB 是一个介于关系数据库和非关系数据库之间的产品,是非关系数据库当中功能最丰富,最像关系数据库的...

99520
来自专栏电光石火

@Bean方法

@Bean是一个方法级别上的注解,主要用在@Configuration注解的类里,也可以用在@Component注解的类里。添加的bean的id为方法名 定义...

357100
来自专栏Hongten

Hibernate延迟加载 lazy loading

/**  *  * @author XHW  *  * @date 2011-7-18  *  */ public class HibernateTest...

19820
来自专栏技术墨客

Spring核心——@Configuration与混合使用

在介绍Spring核心容器的系列文章中已经多次出现这个注解,从使用的角度来说可以把他理解为XML配置中的<beans>标签,但是两者肯定是不等价的。

13930
来自专栏我是攻城师

万法归宗之Hadoop编程无界限

34470
来自专栏一个会写诗的程序员的博客

Spring Boot 使用 Kotlin Script Template 模板引擎kts 开发web

在 Spring Framework 5.0 M4 中引入了一个专门的Kotlin支持。

24020

扫码关注云+社区

领取腾讯云代金券