用Java实现HTTP Multipart的服务端和客户端

今天简单介绍一下如何用Java支持HTTP Multipart的request和response。 整个项目的代码可以在https://github.com/mcai4gl2/multi下载。

在这个程序里，我们的业务场景很简单。在服务端有一个随机数生成器，可以生成随机的Integer和Guid，客户端通过服务，可以请求一个或多个随机数。同时，客户端可以向服务端发送一个或多个随机数，这些随机数会被加入到一个队列中，被其他的客户端通过请求获得。以下是我们的随机数Bean的定义：

[java] view plaincopy

  1. public class RandNumber {
  2. private String uuid;
  3. private Integer number;
  4. public String getUuid() {
  5. return uuid;
  6. }
  7. public void setUuid(String uuid) {
  8. this.uuid = uuid;
  9. }
  10. public Integer getNumber() {
  11. return number;
  12. }
  13. public void setNumber(Integer number) {
  14. this.number = number;
  15. }
  16. @Override
  17. public String toString() {
  18. return number + " " + uuid;
  19. }
  20. public static class Builder {
  21. private RandNumber number;
  22. public Builder() {
  23. number = new RandNumber();
  24. }
  25. public Builder randomlyGenerate() {
  26. Random random = new Random();
  27. number.setNumber(random.nextInt(100));
  28. number.setUuid(UUID.randomUUID().toString());
  29. return this;
  30. }
  31. public Builder withNumber(int num) {
  32. number.setNumber(num);
  33. return this;
  34. }
  35. public Builder withUuid(String uuid) {
  36. number.setUuid(uuid);
  37. return this;
  38. }
  39. public RandNumber build() {
  40. return number;
  41. }
  42. }
  43. }

在这个类中，我们除了定义类的基本信息，还添加了一个Builder类。通过这个Builder类，我们可以很方便的生成RandNumber类。Builder类在我们的数据类的Constructor很复杂的时候，非常有用，可以使我们的代码更具可读性。

有了这个简单的数据类，我们继续定义一个简单的业务类RandomNumberGenerator，它继承了IRandomNumberGenerator接口：

[java] view plaincopy

  1. public interface IRandomNumberGenerator {
  2. RandNumber getRandomNumber();
  3. RandNumber[] getRandomNumbers(int num);
  4. void submitRandomNumber(RandNumber randNumber);
  5. void submitRandomNumbers(RandNumber[] randNumbers);
  6. }

同时，我们还定义了一个RandomNumberSerializer类，它可以对我们的数据类进行JSON Serialization操作，我们的服务端和客户端都将使用它进行通信：

[java] view plaincopy

  1. public interface IRandomNumberSerializer {
  2. String serializeRandomNumber(RandNumber number);
  3. RandNumber deserializeRandomNumber(String input);
  4. void serializeRandomNumber(RandNumber number, OutputStream stream);
  5. RandNumber deserializeRandomNumber(InputStream stream);
  6. String getContentType();
  7. }

RandomNumberSerializer内部使用了Gson包来进行序列化操作。在上面的接口中，我们提供了对String和Stream的两种方法，这样，当我们进行HTTP通信的时候，我们可以直接对Network Stream进行操作。

有了上面的这些类，我们的Servlet服务端代码就很简单了：

[java] view plaincopy

  1. @Controller
  2. public class MultiPartRequestServlet {
  3. private static Logger log = Logger.getLogger(MultiPartRequestServlet.class);
  4. @Autowired
  5. private IRandomNumberSerializer randomNumberSerializer;
  6. @Autowired
  7. private IRandomNumberGenerator randomNumberGenerator;
  8. @RequestMapping(value="/get-multi", method = RequestMethod.GET)
  9. public void getMultiple(
  10. @RequestHeader("MAX_NUM_NUMS") int maxCount,
  11. HttpServletRequest request,
  12. HttpServletResponse response,
  13. ServletOutputStream outputStream) throws Exception {
  14. log.info("multi part get is called");
  15. response.setStatus(HttpServletResponse.SC_OK);
  16. String boundary = UUID.randomUUID().toString();
  17. response.setContentType("multipart/x-mixed-replace;boundary=" + boundary);
  18. RandNumber[] numbers = randomNumberGenerator.getRandomNumbers(maxCount);
  19. for (int index = 0; index < maxCount; index++) {
  20. outputStream.println("--" + boundary);
  21. outputStream.println("Content-Type: " + randomNumberSerializer.getContentType());
  22. outputStream.println();
  23. outputStream.println(randomNumberSerializer.serializeRandomNumber(numbers[index]));
  24. outputStream.println();
  25. }
  26. outputStream.println("--" + boundary + "--");
  27. outputStream.flush();
  28. outputStream.close();
  29. }
  30. @RequestMapping(value="/submit-multi", method = RequestMethod.POST)
  31. public void submitMultiple(HttpServletRequest request, HttpServletResponse response) throws Exception {
  32. log.info("multi part submit is called");
  33. if (!request.getContentType().startsWith("multipart/form-data")) {
  34. response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
  35. } else {
  36. request.setAttribute("org.eclipse.multipartConfig",
  37. new MultipartConfigElement(System.getProperty("java.io.tmpdir")));
  38. Collection<Part> parts = request.getParts();
  39. for (Part part : parts) {
  40. RandNumber number = randomNumberSerializer.deserializeRandomNumber(part.getInputStream());
  41. randomNumberGenerator.submitRandomNumber(number);
  42. }
  43. response.setStatus(HttpServletResponse.SC_OK);
  44. }
  45. }
  46. @RequestMapping(value="/get-one", method = RequestMethod.GET)
  47. public void getOne(HttpServletRequest request, HttpServletResponse response, OutputStream outputStream) throws Exception {
  48. log.info("get is called");
  49. RandNumber number = randomNumberGenerator.getRandomNumber();
  50. response.setStatus(HttpServletResponse.SC_OK);
  51. response.setContentType(randomNumberSerializer.getContentType());
  52. randomNumberSerializer.serializeRandomNumber(number, outputStream);
  53. outputStream.flush();
  54. outputStream.close();
  55. }
  56. @RequestMapping(value="/submit-one", method = RequestMethod.POST)
  57. public void submitOne(HttpServletRequest request, HttpServletResponse response) throws Exception {
  58. log.info("submit is called");
  59. RandNumber number = randomNumberSerializer.deserializeRandomNumber(request.getInputStream());
  60. randomNumberGenerator.submitRandomNumber(number);
  61. response.setStatus(HttpServletResponse.SC_OK);
  62. }
  63. }

在上面的代码中，getOne和submitOne很简单，这里我们主要讨论getMultiple和submitMultiple。在getMultiple中，我们直接操作outputStream来实现Multipart协议。而在submitMultiple中，我们则通过Servlet 3.0的getParts方法来直接获得每一个Part。需要注意的是，getParts是在Servlet 3.0中才新添加的方法，在我们部署服务的时候，我们要部署在支持Servlet 3.0的container里（在这里我对Tomcat7和Jetty8进行了测试）。同时，我们在调用getParts之前，我们对request添加了一个attribute，这个attribute只在部署在Jetty时需要。

下面的代码是一个简单的getMultiple的客户端，在这段代码中，我们使用Apache HttpClient来进行HTTP，我们使用了java mail中的MimeMultipart来处理服务端的repsonse。

[java] view plaincopy

  1. @Override
  2. public RandNumber[] getRandomNumbers(int num) {
  3. HttpGet httpGet = new HttpGet(getMultipleUrl);
  4. httpGet.setHeader("MAX_NUM_NUMS", Integer.toString(num));
  5. try {
  6. HttpResponse httpResponse = httpClient.execute(httpGet);
  7. if (httpResponse.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
  8. ByteArrayDataSource source = new ByteArrayDataSource(httpResponse.getEntity().getContent(),
  9. "multipart/mixed");
  10. MimeMultipart multipart = new MimeMultipart(source);
  11. List<RandNumber> numbers = new ArrayList<RandNumber>();
  12. for (int index = 0; index < multipart.getCount(); index++) {
  13. numbers.add(randomNumberSerializer.deserializeRandomNumber(multipart.getBodyPart(index).getInputStream()));
  14. }
  15. return numbers.toArray(new RandNumber[numbers.size()]);
  16. } else {
  17. HttpEntity httpDataEntity = httpResponse.getEntity();
  18. EntityUtils.consumeQuietly(httpDataEntity);
  19. return null;
  20. }
  21. } catch (Exception ex) {
  22. log.error("Failed to get multiple random numbers", ex);
  23. return null;
  24. }
  25. }

除了代码，我还添加了Maven打包配置和发布到local tomcat的脚本。整个Maven项目会被打包成两个文件，一个JAR和一个WAR。JAR打包包含了一个Jetty的服务端程序入口，和一个SampleClient的程序入口。而另一个WAR包可以直接发布到Tomcat上进行调试。这些都是为了我们可以更方便的在本地进行代码调试，在tomcat的启动脚本中，我还打开了JPDA端口，这样我们可以通过IDE对部署在Tomcat上的服务端进行调试。

这些基本的配置，可以大大提高我们编程调试的效率。这也是我写这篇文章的另一个原因。希望这些配置，可以帮到有需要的朋友。

原文：http://blog.csdn.net/mcai4gl2/article/details/12354945

时间： 2024-10-26 07:40:07

用Java实现HTTP Multipart的服务端和客户端的相关文章

Java网络编程【Socket服务端和客户端】

Socket 编程大家都不陌生,Java 学习中必学的部分,也是 Java网络编程核心内容之一.Java 网络编程又包括 TCP.UDP,URL 等模块.TCP 对应 Socket模块,UDP 对应 DatagramPacket 模块.URL 对应 URL 模块.其中 TCP 和 UDP 是网络传输协议,TCP 是数据流传输协议,UDP 是数据包传输协议.两者之间的异同就不在这里说了,推荐一本入门书籍 <TCPIP入门经典>.我们开始 Socket 服务端和客户端编程吧. 一.Socket 服

Java网络编程(TCP协议-服务端和客户端交互)

客户端: 1 package WebProgramingDemo; 2 3 import java.io.IOException; 4 import java.io.InputStream; 5 import java.io.OutputStream; 6 import java.net.Socket; 7 import java.net.UnknownHostException; 8 9 public class SocketDemo { 10 11 /** 12 * @param args

java中socket创建服务端与客户端即时对聊

package tool; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStream; import java.io.InputStreamReader; import java.io.OutputStream; import java.io.PrintWriter; import java.net.ServerSocket; import java.net.Socket; impo

grpc（3）：使用 golang 开发 grpc 服务端和客户端

1,关于grpc-go golang 可以可以做grpc的服务端和客户端. 官网的文档: http://www.grpc.io/docs/quickstart/go.html https://github.com/grpc/grpc-go 和之前写的java的grpc客户端调用相同.也需要使用protobuf的配置文件. 但是golang下面的类库非常的简单,而且golang的性能也很强悍呢. 有些简单的业务逻辑真的可以使用golang进行开发. 性能强悍而且,消耗的资源也很小.java感觉上已

webService服务端和客户端开发 简单实例

这几天一直在看webService相关的知识. webService是一个跨平台访问的第三方插件,方便易用,多平台使用. 开发中我们可能自己是服务端,提供webService接口给别人访问我们的系统:也有可能我们调用别人的webService接口去访问别人的系统(比如查询天气预报). 下面是服务端和客户端的开发,实际开发中我们只是其中一方. 服务端开发: ①创建一个服务类,运行main方法发布即可,服务端就开发完成了. package com.lijianbo.service; import j

使用Apache CXF开发WebServices服务端、客户端

在前一篇的博客中,我使用Xfire1.x来开发了WebServies的服务端. 但是如果你访问Apache的官网,可以看到xfire已经被合并了. 最新的框架叫做CXF. Apache CXF = Celtix + XFire. CXF 继承了 Celtix 和 XFire 两大开源项目的精华, 提供了对 JAX-WS 全面的支持,并且提供了多种 Binding .DataBinding.Transport 以及各种 Format 的支持,并且可以根据实际项目的需要,采用代码优先(Code Fi

mvn构建JAX-WS项目含服务端和客户端代码实现

java中WebService框架有很多,像Axis,XFire,CXF等,除了上述框架外,JDK中自带JAX-WS框架.相比而言,JWS是轻量级的,使用非常简便,可与Spring集成使用. 下面就详述如何通过mvn构建WebService服务端及客户端. 1.引包. 在mvn项目的pom文件中加入依赖包 <dependency> <groupId>com.sun.xml.ws</groupId> <artifactId>jaxws-rt</artif

在eclipse中使用jax-ws构建webservices服务端和客户端

服务端: package com.yinfu.service; import javax.jws.WebService; import javax.xml.ws.Endpoint; @WebService public class TestWebsService { public String sayHello(String username) { return "Hello: " + username; } public static void main(String[] args)

spring + cxf 的webservice服务端和客户端功能

原文:spring + cxf 的webservice服务端和客户端功能 源代码下载地址:http://www.zuidaima.com/share/1550463730928640.htm spring + cxf 的webservice服务端和客户端功能. 提供页面调用ws和java代码调用两种方式. 引用jar包请下载:http://pan.baidu.com/s/1jGog2WI