一个简洁的java http框架.rar

# FHTTP: 一个简洁易用的java http框架 **FHTTP抛弃了已有的web服务器，从serversocket开始， 直接构建http服务，从零编写http服务器，并对使用者提供简单的使用方法** **框架内部所有数据全部使用utf-8编码处理且不支持修改** [项目地址](https://gitee.com/forestrabbit/fhttp) version: 1.3.2 and 1.3.3 1.3.2 and 1.3.3修复提交文件名中文乱码问题以及其它一些bug version: 1.3.1 1.3.1修正了上传文件时的bug version: 1.3 ### 1.3新功能 1.3版本添加了对jwt token的支持，使用方法如下 设置一个验证器 ``` response.getJwtBuilder().withClaim("userName", "root").withExpiresAt( Date.from(LocalDateTime.now().plusHours(1).atZone(ZoneId.systemDefault()).toInstant() )); response.setJwtPassord("123456789"); ``` 框架会将生成的token写入http header中的Authorization项目中 读取一个验证器 ``` @Token("123456789") public String handlerMain(Map<String, Claim> claimMap) { if (claimMap.containsKey(key) && claimMap.get(key).asString().equals(value)) { return "<h1>hello, world</h1>"; } else { return "<h1>please login first</h1>"; } } ``` 如果一个mapping方法设置了Token注解，框架会在请求的request头中查找Authorization头，如果 没找到，抛出异常；找到的话，以Token注解的字符串为密码，验证token是否正确，如果正确，在参数中存在Map<String, Claim>类型的情况下将claimMap传给函数，否则返回403 验证失败 1.3版本增加了对http长连接的支持，节省了创建socket的时间 1.3版本增加了@Raw注解，在方法上使用此注解，并在方法参数上使用OutputStream类型参数，可以在方法中 操作socket的输出流，直接写数据，例如 ``` @Raw @Mapping("/image_raw") public void handleRaw(OutputStream output) throws IOException { output.write("HTTP/1.1 200 OK\r\nContent-Type: image/jpeg\r\nTransfer-Encoding: chunked\r\n\r\n".getBytes(StandardCharsets.UTF_8)); var buffer = new byte[100]; try (var input = Test2.class.getClassLoader().getResourceAsStream("a.jpg")) { int n; while (true) { assert input != null; if ((n = input.read(buffer)) == - 1) break; output.write((Integer.toHexString(n) + "\r\n").getBytes(StandardCharsets.UTF_8)); output.write(buffer, 0, n); output.write("\r\n".getBytes(StandardCharsets.UTF_8)); } } output.write("0\r\n\r\n".getBytes(StandardCharsets.UTF_8)); } ``` 使用Raw注解后，框架仍然会将客户端传来的参数进行解析并传递到方法上， 但是，任何与输出流有关的信息都需要手动通过socket输出流设置 1.3版本支持如下方式打jar包 ```xml <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-shade-plugin</artifactId> <version>3.2.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> <configuration> <transformers> <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"> <mainClass>Main</mainClass> </transformer> </transformers> </configuration> </execution> </executions> </plugin> ``` version: 1.2.2 修复上传json的bug，支持查看未经解析的原始上传数据 ### 1.2.2新功能 1.2.2 版本支持查看未经解析的原始上传数据 ``` byte[] data = request.getRawData(); ``` version: 1.2.1 支持post表单上传json格式数据，支持查看上传表单文件的文件名 ### 1.2.1新功能 1.2.1 版本查看上传表单文件的文件名 ``` request.getFileInputStream(key).getFileName(); ``` version: 1.2 版本使用新的方法启动框架并且支持jar运行 ### 1.2新功能 1.2 版本使用如下方式启动框架 ``` new FHTTP(启动类.class).start(); ``` 框架会以启动类所在目录为根目录，自动寻找其它类 框架推荐使用如下maven插件打包 ```xml <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-jar-plugin</artifactId> <version>3.2.0</version> <configuration> <archive> <manifest> <mainClass>Main</mainClass> <addClasspath>true</addClasspath> <classpathPrefix>dependencies/</classpathPrefix> </manifest> </archive> </configuration> </plugin> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-dependency-plugin</artifactId> <version>3.1.1</version> <executions> <execution> <phase>package</phase> <goals> <goal>copy-dependencies</goal> </goals> <configuration> <outputDirectory>${project.build.directory}/dependencies/</outputDirectory> <includeScope>runtime</includeScope> <useBaseVersion>true</useBaseVersion> </configuration> </execution> </executions> </plugin> </plugins> ``` version: 1.1.2 版本使用更新的方法获取用户上传的文件 示例：获取表单中name为img的文件 ``` try (var output = new FileOutputStream("...")) { try (var input = request.getFileInputStream("img")) { output.write(input.readAllBytes()); //获取文件的mime类型 String mime = input.getMimeType(); } } ``` version: 1.1.1 修复默认情况下框架加载内部404, 500页面失败问题 version: 1.1.0 增加404以及500的处理功能 ## 404和500 如果没有指定自定义的404以及500处理函数，框架会调用内部自带的一个简陋的404以及500页面， 如果想要进行自定义，可以在Controller中定义一个带有@Status("404 ...")或@Status("500 ...") 的方法，此方法不需要带有@Mapping注解，另外，被标注为404或500的处理函数，必须返回一个html页面。 框架建议，只定义一个404和500处理函数 version: 1.0.1 修复http方法为head时的bug version: 1.0 ## 使用方法 ### 启动服务器 首先，在main方法中，需要用以下代码开启一个http服务 ``` new FHTTP(启动类.class).start(); //详见1.2版本更新 //new FHTTP("项目类路径").start(); 过时 ``` 其中，项目类路径非常重要，框架将在这个路径上搜索其它代码， 一般选择main函数所在类的路径作为项目类路径(已过时) 以上代码会默认开启一个监听端口为8080的socket，如果想要更改端口， 请使用FHTTP类的setPort(int port)方法，例如 ``` //var fhttp = new FHTTP("项目类路径"); 过时 var fhttp = new FHTTP(启动类.class); //详见1.2版本更新 fhttp.setPort(8000); ``` 使用FHTTP的getPort方法可以获得当前监听的端口 ### 编写Controller 一旦框架启动，框架会在类路径范围内所有目录下搜索带有@Controller注解的类， 并寻找类中标有@Mapping注解的方法，一旦寻找成功，框架会将http请求中的url对应到相应的方法上，使用方法如下 ```java @Controller public class Test2 { @Mapping("/") public Object handleIndex() { return something; } @Mapping("/x") public void handleX() { //TODO } } ``` 当浏览器访问url为/时，框架将会调用Test2中的handleIndex方法， 当浏览器访问url为/x时，框架将会调用Test2中的handleX方法 Controller注解中也可以写入url，例如 ```java @Controller("/c1") public class Test2 { @Mapping("/") public Object handleIndex() { return something; } @Mapping("/x") public void handleX() { //TODO