Vertx和Jersey集成使用

为了更好地解耦和提高性能，一般将工程的接口部分剥离出来形成一个单独的工程，这样不仅能提高性能，增强可维护性，并且在后台工程宕掉的话对客户端接口的影响较小。

公司使用了Vertx和Jersey，Vert.x是一个基于JVM、轻量级、高性能的应用平台，非常适用于最新的移动端后台、互联网、企业应用架构。Vert.x基于全异步Java服务器Netty，并扩展出了很多有用的特性;Jersey RESTful 框架是开源的RESTful框架, 实现了JAX-RS (JSR 311 & JSR 339) 规范。它扩展了JAX-RS 参考实现， 提供了更多的特性和工具， 可以进一步地简化 RESTful service 和 client 开发。尽管相对年轻，它已经是一个产品级的 RESTful service 和 client 框架。与Struts类似，它同样可以和hibernate,spring框架整合。程序中主要与jersey打交道。使用binder绑定filter和processor到内核中，做一些前置处理。基本的工程样子如下：

启动一个MainVerticle，用于整个程序的初始化和启动jersey服务器。

 

/**
 * 运行方式：Windows：dy-server-api.bat run java-hk2:cn.esstx.dzg.api.tinyhttp.MainVerticle
 *          Linux: nohup ./bin/dy-server-api run java-hk2:cn.esstx.dzg.api.tinyhttp.MainVerticle &
 *                 nohup ./bin/dy-server-api run java-hk2:cn.esstx.dzg.api.tinyhttp.MainVerticle -Dlogback.configurationFile=config/logback.xml &
 */
public class MainVerticle extends AbstractVerticle {
    //日志框架最好使用slf4j，这样很好滴更换底层实现，例如使用log4j，logback，jdklog
    public static void main(String[] args) {
        // Create an HTTP server which simply returns "Hello World!" to each request.
          Runner.runServer(MainVerticle.class);
    }

  @Override
  public void start() throws Exception {
      /*程序的其他一些初始化，我们工程就需要初始化JFinal和系统的配置文件*/
      
      DeploymentOptions options = new DeploymentOptions();
      String path = new PropertiesConfiguration("config/config.json").getPath();
      //System.out.println(path);
      JsonObject config = JsonConfigUtil.loadConfig(path);
      options.setConfig(config);
      vertx.deployVerticle("java-hk2:com.englishtown.vertx.jersey.JerseyVerticle", options);
  }
}

 

public class Runner{

    private static final String WEB_JAVA_DIR = "/src/main/java/";

    public static void runClusteredServer(Class<?> clazz){
        runServer(WEB_JAVA_DIR, clazz, new VertxOptions().setClustered(true), null);
    }

    public static void runServer(Class<?> clazz){
        runServer(WEB_JAVA_DIR, clazz, new VertxOptions().setClustered(false), null);
    }

    public static void runServer(Class<?> clazz, DeploymentOptions options){
        runServer(WEB_JAVA_DIR, clazz, new VertxOptions().setClustered(false), options);
    }

    public static void runServer(String dir, Class<?> clazz, VertxOptions options,
            DeploymentOptions deploymentOptions){
        runServer(dir + clazz.getPackage().getName().replace(".", "/"), clazz.getName(), options,
                  deploymentOptions);
    }

    public static void runScriptServer(String prefix, String scriptName, VertxOptions options){
        File file = new File(scriptName);
        String dirPart = file.getParent();
        String scriptDir = prefix + dirPart;
        runServer(scriptDir, scriptDir + "/" + file.getName(), options, null);
    }

    public static void runServer(String dir, String verticleID, VertxOptions options,
            DeploymentOptions deploymentOptions){
        if(options == null){
            // Default parameter
            options = new VertxOptions();
        }
        // Smart cwd detection

        // Based on the current directory (.) and the desired directory
        // (exampleDir), we try to compute the vertx.cwd
        // directory:
        try{
            // We need to use the canonical file. Without the file name is .
            File current = new File(".").getCanonicalFile();
            if(dir.startsWith(current.getName()) && !dir.equals(current.getName())){
                dir = dir.substring(current.getName().length() + 1);
            }
        }
        catch(IOException e){
            // Ignore it.
        }
        System.out.println(dir);
        System.out.println(verticleID);
        System.setProperty("vertx.cwd", dir);
        Consumer<Vertx> runner = vertx -> {
            try{
                if(deploymentOptions != null){
                    vertx.deployVerticle(verticleID, deploymentOptions);
                } else{
                    vertx.deployVerticle(verticleID);
                }
            }
            catch(Throwable t){
                t.printStackTrace();
            }
        };
        if(options.isClustered()){
            Vertx.clusteredVertx(options, res -> {
                if(res.succeeded()){
                    Vertx vertx = res.result();
                    runner.accept(vertx);
                } else{
                    res.cause().printStackTrace();
                }
            });
        } else{
            Vertx vertx = Vertx.vertx(options);
            runner.accept(vertx);
        }
    }
}

{
    "host": "localhost",
    "port": 9090,
    "base_path": "/rest/dy",
    "resources": ["cn.esstx.dzg.api.tinyhttp.resources"],
    "features": [],
    //"binders": ["cn.esstx.dzg.api.tinyhttp.binder.RequestBinder"],//仅对filter有用
    "hk2_binder": [
        "com.englishtown.vertx.hk2.BootstrapBinder",
        "cn.esstx.dzg.api.tinyhttp.binder.RequestBinder"
    ]
}

具体的使用方式：

@Path("/test")
public class TestResouce {

    @GET
    public String doGet() {
        return "Hello World!";
    }
    @POST
    @Produces(MediaType.APPLICATION_JSON)
    public MyObject getJson() {
        MyObject o = new MyObject();
        o.setName("Andy");
        return o;
    }

    @GET
    @Path("jsonp")
    @JSONP(queryParam = "cb")
    @Produces("application/javascript")
    public MyObject getJsonPadding() {
        MyObject o = new MyObject();
        o.setName("Andy");
        return o;
    }

    @POST
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)
    public MyObject postJson(MyObject in) {
        return in;
    }

    @POST
    @Path("json")
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)
    public JsonObject postJson2(JsonObject in) {
        return in;
    }

    @GET
    @Path("async")
    @Produces(MediaType.APPLICATION_JSON)
    public void getJsonAsync(@Suspended final AsyncResponse asyncResponse, @Context Vertx vertx) {
        vertx.runOnContext(aVoid -> {
            MyObject o = new MyObject();
            o.setName("Andy");
            asyncResponse.resume(o);
        });
    }

    public static class MyObject {

        private String name;

        public String getName() {
            return name;
        }

        public void setName(String name) {
            this.name = name;
        }
    }
    
    
    
    测试Post和Get获取参数/
    //get可以使用@Context、@QueryParam/
    //post可以使用@FormParam、MultivaluedMap<String, String> formParams
    //都可以使用@DefaultValue/
    //QueryParam--url ? 后面表示的参数  .  get post 通用.
    //PathParam---url中的一部分，例如用{}表示的url中的一部分。get post 通用。
    //FormParam---post提交的form表单参数。     用于 post 
    @GET
    @Path("/dd")
    public String getRequest(@Context HttpServerRequest request) {
        String dd  = request.params().get("dd");
        System.out.println(dd);
        return dd;
    }
    @GET
    @Path("/ds")
    public String getQuery(@QueryParam("dd") String dd) {
        return dd;
    }
    @POST
    @Path("/dd")
    @Produces(MediaType.APPLICATION_JSON)
    public String postForm(
            @FormParam(value = "dd") String dd,
            @FormParam(value = "ds") String ds) {
        System.out.println(dd+ds);
        return dd+ds;
    }
    @POST
    @Path("/ds")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON)
    public String postRequest(
            @DefaultValue("dd") 
            @FormParam("dd") 
            String dd) {
        return dd;
    }
    
    @POST
    @Path("/ss")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON)
    public String postJson(@DefaultValue("dd") @FormParam("dd") String dd) {
        JsonObject object = new JsonObject();
        object.put("dd", dd);
        return object.toString();
    }
    
    @POST
    @Path("/sd")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON)
    public String postContext(MultivaluedMap<String, String> formParams) {
        String dd = formParams.getFirst("dd");
        List<String> ds = formParams.get("ds");
        return dd+ds.toString();
    }
    
    @POST
    @Path("/sssss")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON)
    public String postQuery(@QueryParam("ss") String ss,@FormParam("dd") String dd) {
        return dd+ss;//?ss=ss      dd=dd
    }
    
    @POST
    @Path("/sssss2")
    @Consumes(MediaType.APPLICATION_FORM_URLENCODED)
    @Produces(MediaType.APPLICATION_JSON)
    //http://localhost:9090/rest/dy/test/sssss2?ss=ss&sd=sd
    public String postQuery2(MultivaluedMap<String, String> params) {
        for(String ss:params.keySet()){
            System.out.println(params.getFirst(ss));//只有form里面的
        }
        return ""+params.size();
    }
    
    @POST
    @Path("/redirect")
    @Produces(MediaType.TEXT_HTML)
    public String redirect(){
        return Utils.redirectTo("http://www.hao123.com");
    }
}

 

 /**
     * 
     * @param location 需要重定向的位置
     * @des 利用meta标签实现重定向
     */
    public static String redirectTo(String location){
        return "<!DOCTYPE><HTML><HEAD><TITLE>跳转页面</TITLE><meta http-equiv=\"refresh\" content=\"0; URL="+location+"\"></HEAD><BODY></BODY></HTML>";
    }

 

 

 

 

 

上传文件：

添加jar

// https://mvnrepository.com/artifact/org.glassfish.jersey.media/jersey-media-multipart
compile group: 'org.glassfish.jersey.media', name: 'jersey-media-multipart', version: '2.17'

配置文件中："features": ["org.glassfish.jersey.media.multipart.MultiPartFeature"]

DefaultJerseyHandler中的shouldReadData中添加

 

if(MediaType.MULTIPART_FORM_DATA_TYPE.getType().equalsIgnoreCase(mediaType.getType())
                && MediaType.MULTIPART_FORM_DATA_TYPE.getSubtype().equalsIgnoreCase(mediaType.getSubtype())){
            return true;
        }

 

 

 

 

 

 

<form action="http://127.0.0.1:8090/api/yyh/test/postFile" method="post" enctype="multipart/form-data">
		<input type="file" name="postFile"/>
		<input type="text" name="username"/>
		<input type="submit" name="上传"/>
	</form>
	
	<form action="http://127.0.0.1:8090/api/yyh/test/postFile2" method="post" enctype="multipart/form-data">
		<input type="file" name="postFile"/>
		<input type="text" name="username"/>
		<input type="submit" name="上传"/>
	</form>

 

 

 

 

 

 

@POST
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    @Path("/postFile")
    // @Produces(MediaType.TEXT_PLAIN)
    // public String postFile(@FormDataParam("postFile") InputStream stream,
    // @FormDataParam("postFile") FormDataContentDisposition fileDisposition){
    public String postFile(FormDataMultiPart form){
        // 获取表单的其他数据
        FormDataBodyPart usernamePart = form.getField("username");
        System.out.println("name = " + usernamePart.getName() + " ,value = " + usernamePart.getValue());

        // ContentDisposition headerOfFilePart =
        // filePart.getContentDisposition();
        // 把表单内容转换成流
        try{
            // 获取文件流
            FormDataBodyPart filePart = form.getField("postFile");
            System.out.println("MediaType = " + filePart.getMediaType());

            InputStream fileInputStream = filePart.getValueAs(InputStream.class);
            int len = 1024;// fileInputStream.available();
            System.out.println("len = " + len);
            byte[] buff = new byte[len];
            len = fileInputStream.read(buff, 0, len);
            System.out.println("content = " + new String(buff, 0, len));

            FormDataContentDisposition formDataContentDisposition = filePart.getFormDataContentDisposition();

            String source = formDataContentDisposition.getFileName();
            String result = new String(source.getBytes("ISO8859-1"), "UTF-8");

            System.out.println("result = " + result);
        }
        catch(IOException e1){
            e1.printStackTrace();
        }

        return "上传成功";
    }

    @POST
    @Consumes(MediaType.MULTIPART_FORM_DATA)
    @Path("/postFile2")
    @Produces(MediaType.TEXT_PLAIN)
    public String postFile2(@FormDataParam("postFile") InputStream stream,
            @FormDataParam("postFile") FormDataContentDisposition fileDisposition,
            @FormDataParam("username") String username){
        System.out.println(username);
        try{
            // 这里坑死人了，不能用stream.available()，为0，available不可靠
            java.io.File file = new java.io.File(fileDisposition.getFileName());
            FileOutputStream stream2 = new FileOutputStream(file);
            int len = 1024;
            System.out.println("len = " + len);
            byte[] buff = new byte[len];
            len = stream.read(buff, 0, len);
            stream2.write(buff, 0, len);
            System.out.println("content = " + new String(buff, 0, len));
            stream2.close();
            System.out.println("fileName = " + fileDisposition.getFileName());
        }
        catch(IOException e1){
            e1.printStackTrace();
        }

        return "上传成功";
    }