# jclient
**Repository Path**: clouddea/jclient
## Basic Information
- **Project Name**: jclient
- **Description**: 使用Web界面（HTML界面）作为Java的图形界面构建客户端，酷！
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-11-20
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 简介
本项目可以让java拥有编写客户端的能力。我们都知道，Java自带的AWT和Swing不仅难用，还很丑。
很少有人喜欢用它们。于是我萌生了使用HTML作为客户端的想法，于是诞生了这个项目。本项目是一个框架。
同时，也可以基于本框架开发Web项目。
本项目具有以下特点：
+ 支持get参数
+ 支持post参数
+ 支持cookie
+ 支持ssission
+ 支持formdata及文件传输
+ 支持静态包含（include）
# 效果
### 示例程序界面
程序界面用HTML编写，通过HTTP协议与Java进行交互。
### 托盘提示
### 托盘菜单
可以自定义托盘图标和托盘菜单。实现想要实现的功能。
# 快速使用
+ 在github `Release`界面下载最近的版本：`jclient.jar`
+ 导入Jar包到程序中
+ 写入以下代码：
```java
public static void main(String[] args) throws IOException, AWTException {
Server server = new Server(8081);
server.start();
}
```
注意：服务默认`根目录`是`程序的运行目录`。在eclipse中即`.classpath`文件所在目录。其它开发环境可能有所不同。静态目录是`"/static/"`且不可改变。
请把程序界面入口命名为`index.html` 放入静态目录中。
# 基本功能
### 添加路由
Http的请求参数、请求头部、输入流、输出流等等都是通过Request操作的
```java
server.addContext("/", new Handler() {
@Override
public void handle(Request req, Response resp) {
resp.getWriter().println("6666");
}
});
```
### 显示程序界面
```java
server.show()
```
### 退出程序
```java
server.close()
```
# 个性化
### 托盘提示文本
```java
server.setToolTip("提示内容");
```
### 托盘提示图标
```java
Image image = Toolkit.getDefaultToolkit().createImage("icon.jpg");
server.setIcon(image);
```
### 托盘菜单
```java
PopupMenu menu = new PopupMenu();
menu.add(new MenuItem("菜单项一"));
server.setMenu(menu);
```
### 自定义托盘
设置此项后，setToolTip、setIcon、setMenu将失效
```java
TrayIcon icon = new TrayIcon(image, "提示")
server.setTray(icon);
```
### 服务根目录
可以是绝对路径或相对路径，但是必须以`/`结束
```java
server.setRoot("app/");
```
# 输入输出
以下是输入输出的基本使用方式：
```java
//获得参数（不分get或post，同servlet）
req.getParam(String key)
req.getParams()
//请求或响应头
req.getHeader(String key)
req.getHeaders()
resp.setHeader(String key, String value);
//cookie
req.getCookie(String key)
req.getCookies()
resp.setCookie(String key,String value); //默认为根路径，关闭浏览器失效
resp.setCookie(String key,String value,String path,int age); //age 为保留的毫秒数
//session
req.getSession(String key)
req.setSession(String key, String value);
//formdata和文件
FormDataParser parser = new FormDataParser(req.getInputStream());
Field field = parser.getField(String key);
field.getAsString(); //默认为utf-8，只能调用一次
field.getAsString(String encoding); //只能调用一次
field.save(File file) //不可与getAsString混用，且只能调用一次
//输出内容（不可混用）
resp.getWriter(); //默认utf-8
resp.getWriter(String charset)
rresp.getOutputStream()
```
# 静态包含
本框架支持html/htm文件的静态包含。类似于jsp的<%@include file="xxx"%>，可以在一个网页文件中包含另外一个网页文件。
注意不要`循环包含`，这会导致栈溢出。
使用方式如下所示。
```html
```
注意：被包含页面如果更新，包含页面并不会更新，需要你再把它保存一下，即刷新一下它的“修改时间”。
程序检测到文件被修改，则会重新构造。