java 利用JAX-RS快速开发RESTful 服务实例

　　首先看web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <servlet>
        <servlet-name>solr_service</servlet-name>
        <servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>

        <init-param>
            <param-name>jersey.config.server.provider.packages</param-name>
            <param-value>com.solr.service</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>

    <servlet-mapping>
        <servlet-name>solr_service</servlet-name>
        <url-pattern>/api/*</url-pattern>
    </servlet-mapping>
</web-app>

　　

　　1、无参数

package com.solr.service;
import javax.ws.rs.*;

import javax.ws.rs.core.MediaType;
import javax.xml.bind.JAXBElement;
import javax.xml.namespace.QName;
import java.util.List;

@Path("/solr_Data")
public class solrData {

    @GET
    @Path("/getMessage")
    //api/solr_Data/getMessage
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage() {
        return "Hello world!";
    }

}

　　运行结果：

　　

　　2、一个@PathParam参数

   @GET
    @Path("/getMessage/{msg}")
    //http://localhost:8080/api/solr_Data/getMessage/Restful-Webservice
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage(@PathParam("msg") String msg) {

        return String.format("Hello %s !",msg);

    }

　　运行结果

　　

　　3、两个@PathParam参数

    @GET
    @Path("/getMessage/{start}-{end}")
    //http://localhost:8080/api/solr_Data/getMessage/0-10
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage(@PathParam("start") int start,@PathParam("end") int end) {
        return String.format("From %d to %d",start,end);
    }

　　

　　4、一个@QueryParam参数

　　

 @GET
    @Path("/getMessage")
    //api/solr_Data/getMessage?msg=Restful-Webservice
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage(@QueryParam("msg") String msg) {

        return String.format("Hello %s !",msg);

    }

　　http://localhost:8080/api/solr_Data/getMessage?msg=Restful-Webservice

　　

　　5、两个@QueryParam参数

 @GET
    @Path("/getMessage")
    //http://localhost:8080/api/solr_Data/getMessage?msg=Restful-Webservice&start=10
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage(@QueryParam("msg") String msg,@QueryParam("start") int start) {

        return String.format("Hello %s: %d !",msg,start);

    }

　　

　　6、一个PathParam参数，一个QueryParam参数

 @GET
    @Path("/getMessage/{start}")
    //http://localhost:8080/api/solr_Data/getMessage/0?end=10
    @Produces(MediaType.TEXT_PLAIN)
    public String getMessage(@PathParam("start") int start,@QueryParam("end") int end) {
        return String.format("From %d to %d",start,end);
    }

　　

　　7、多个QueryParam参数参，返回xml数据

　　　　solrEntity实体类

package com.solr.service;

/**
 * @Author：sks
 * @Description：
 * @Date：Created in 16:04 2018/3/1
 * @Modified by：
 **/
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;

@XmlRootElement(name = "solrEntity")
public class solrEntity {

    String id;
    @XmlElement
    public String getId() {
        return id;
    }

    public void setid(String id) {
        this.id = id;
    }

    //fileloadDate,keyword,category,fileType,summary
    String fileDate;
    @XmlElement
    public String getFileDate() {
        return fileDate;
    }

    public void setFileDate(String fileDate) {
        this.fileDate = fileDate;
    }

    String category;
    @XmlElement
    public String getCategory() {
        return category;
    }

    public void setCategory(String category) {
        this.category = category;
    }

    String keyword;
    @XmlElement
    public String getKeyword() {
        return keyword;
    }

    public void setKeyword(String keyword) {
        this.keyword = keyword;
    }

    String fileType;
    @XmlElement
    public String getFileType() {
        return fileType;
    }

    public void setFileType(String fileType) {
        this.fileType = fileType;
    }

    String summary;
    @XmlElement
    public String getSummary() {
        return summary;
    }

    public void setSummary(String summary) {
        this.summary = summary;
    }

    String title;
    @XmlElement
    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    String text;
    @XmlElement
    public String getText() {
        return text;
    }

    public void setText(String text) {
        this.text = text;
    }

}

　　　　getQueryData 方法

package com.solr.service;

import org.apache.solr.client.solrj.SolrClient;
import org.apache.solr.client.solrj.SolrQuery;
import org.apache.solr.client.solrj.SolrServerException;
import org.apache.solr.client.solrj.impl.HttpSolrClient;
import org.apache.solr.client.solrj.response.Cluster;
import org.apache.solr.client.solrj.response.QueryResponse;
import org.apache.solr.client.solrj.response.ClusteringResponse;

import org.apache.solr.common.SolrDocument;
import org.apache.solr.common.SolrDocumentList;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
/**
 * @Author：sks
 * @Description：
 * @Date：Created in 9:56 2018/2/26
 * @Modified by：
 **/
public class SolrService {

    private SolrClient solr;

    public SolrService() {
        String urlString = "http://localhost:8983/solr/test";
        solr = new HttpSolrClient.Builder(urlString).build();
    }

    /**
     * @Author：sks
     * @Description：获取文档总数
     * @Date：
     */
    private long getDocTotalCount() {
        long num = 0;
        try {
            SolrQuery params = new SolrQuery();
            params.set("q", "*:*");
            //params.setQuery("*:*");
            QueryResponse rsp = solr.query(params);
            SolrDocumentList docs = rsp.getResults();
            num = docs.getNumFound();
        } catch (SolrServerException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return num;
    }

    /**
     * @Author：sks
     * @Description：获取普通查询数据
     * @Date：
     * @queryWhere：查询条件
     * @showField：显示的字段
     * @sortField: 排序字段
     */
    public List<solrEntity> getQueryData(String queryWhere, String showField, String sortField) {
        SolrQuery params = new SolrQuery();

        //例如：fileloadDate:[2018-02-25 TO 2018-03-1]  AND category:广告营销
        //查询日期在2018-02-25 TO 2018-03-1之间，这里TO 必须是大写，并且category:广告营销的所有数据，
        //多个与条件用AND连接，多个或条件用OR连接，必须是大写
        params.setQuery(queryWhere);

        //id,fileloadDate,keyword,category,fileType,summary 多个字段中间用逗号隔开
        params.setFields(showField);
        //从0页开始
        params.setStart(0);
        params.setRows((int) getDocTotalCount());

        //排序字段  fileloadDate:desc; category:asc
        //字段和排序类型中间用冒号隔开，多个字段中间用分号隔开
        if (sortField != null && sortField.length() != 0) {
            String[] sortFields = sortField.split(";");
            List<SolrQuery.SortClause> sortlist = new ArrayList<SolrQuery.SortClause>();
            SolrQuery.ORDER order;
            for (String sf : sortFields) {
                order = sf.split(":")[1] == "asc" ? SolrQuery.ORDER.asc : SolrQuery.ORDER.desc;
                SolrQuery.SortClause sc = new SolrQuery.SortClause(sf.split(":")[0], order);
                sortlist.add(sc);
            }
            params.setSorts(sortlist);
        }
        List<solrEntity> list = new ArrayList<solrEntity>();
        try {
            QueryResponse queryResponse = solr.query(params);
            SolrDocumentList clr = queryResponse.getResults();
            System.out.println(clr.getNumFound());
            String[] fields = showField.split(",");
            for (SolrDocument sd : clr) {
                solrEntity se = new solrEntity();
                se.setid(sd.get("id").toString());
                se.setCategory(sd.get("category").toString());
                se.setKeyword(sd.get("keyword").toString());
                se.setFileType(sd.get("fileType").toString());
                list.add(se);
            }

        } catch (SolrServerException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return list;
    }

}

　　　　调用方法

@GET
    @Path("/getSolrData")
    //@Produces(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_XML)
    //api/solr_Data/getSolrData?queryWhere=fileloadDate:[2018-02-25 TO 2018-03-1]  AND category:广告营销&showField=id,fileloadDate,keyword,category,fileType&sortField=fileloadDate:desc; category:asc
    public List<solrEntity> getSolrData(@QueryParam("queryWhere") String queryWhere,
                                        @QueryParam("showField") String showField,
                                        @QueryParam("sortField") String sortField) {
        SolrService service = new SolrService();
        //"fileloadDate:[2018-02-25 TO 2018-03-1]  AND category:广告营销"
        //id,fileloadDate,keyword,category,fileType
        //fileloadDate:desc; category:asc
        List<solrEntity> list  = service.getQueryData(queryWhere,showField,sortField);
        return list;
    }

　　浏览器查询：

http://localhost:8080/api/solr_Data/getSolrData?queryWhere=fileloadDate:[2018-02-25 TO 2018-03-1]  AND category:广告营销&showField=id,fileloadDate,keyword,category,fileType&sortField=fileloadDate:desc; category:asc

查询结果：