Skip to content

AndroidServices是一个类似于后端springmvc的框架,基于动态注解的方式,实现Reverse Proxy Server和web server。实现了局域网,外网等多种网络环境下Android 服务器功能的支持!

License

Notifications You must be signed in to change notification settings

hirezy/AndroidServices

Repository files navigation

AndServer

Logo

AndServer is an HTTP and reverse proxy server.

Web server and Web framework of Android platform. It provides annotations like SpringMVC, and if you are familiar with SpringMVC, you can master it very quickly.

  • Static html website deployment.
  • Dynamic http api deployment.
  • Reverse proxy server.

Web Server

Deploy a web server:

Server server = AndServer.webServer(context)
    .port(8080)
    .timeout(10, TimeUnit.SECONDS)
    .build();

// startup the server.
server.startup();

...

// shutdown the server.
server.shutdown();

It also has some features, such as inetAddress(InetAddress), serverSocketFactory(ServerSocketFactory) and sslContext(SSLContext), depending on what you want to achieve.

@RestController
@RequestMapping(path = "/user")
public class UserController {

    @PostMapping("/login")
    public String login(@RequestParam("account") String account,
                        @RequestParam("password") String password) {

        ...
        return "Successful.";
    }

    @GetMapping(path = "/{userId}")
    public User info(@PathVariable("userId") String userId,
                     @QueryParam("fields") String fields) {

        User user = findUserById(userId, fields);
        ...

        return user;
    }

    @PutMapping(path = "/{userId}")
    public void modify(@PathVariable("userId") String userId
                       @RequestParam("age") int age) {
        ...
    }
}

The above code will generate the following two http apis:

POST http://.../user/login
GET http://.../user/uid_001?fields=id,name,age
PUT http://.../user/uid_001

Get connection information with the client:

@GetMapping(path = "/connection")
void getConnection(HttpRequest request, ...) {
    request.getLocalAddr();   // HostAddress
    request.getLocalName();   // HostName
    request.getLocalPort();   // server's port

    request.getRemoteAddr();  // HostAddress
    request.getRemoteHost();  // Especially HostName, second HostAddress
    request.getRemotePort();  // client's port

    ...
}

Reverse Proxy Server

Deploy a reverse proxy server:

Server server = AndServer.proxyServer()
    .addProxy("www.example1.com", "http://192.167.1.11:8080")
    .addProxy("example2.com", "https://192.167.1.12:9090")
    .addProxy("55.66.11.11", "http://www.google.com")
    .addProxy("192.168.1.11", "https://github.com:6666")
    .port(80)
    .timeout(10, TimeUnit.SECONDS)
    .build();

// startup the server.
server.startup();

...

// shutdown the server.
server.shutdown();

Note: It is just a reverse proxy and does not have the ability to take care of loading balance.

Download

Add the plugin to your project build script :

buildscript {
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.hirezy.andserver:plugin:1.0.0'
        ...
    }
}

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}
...

And then add AndServer dependency to your module:

apply plugin: 'com.hirezy.andserver'

...

dependencies {
    implementation 'com.hirezy.andserver:api:1.0.0'
    annotationProcessor 'com.hirezy.andserver:processor:1.0.0'
    ...
}

If you are using Kotlin, replace annotationProcessor with kapt.

About

AndroidServices是一个类似于后端springmvc的框架,基于动态注解的方式,实现Reverse Proxy Server和web server。实现了局域网,外网等多种网络环境下Android 服务器功能的支持!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages