downgoon/jresty

a tranditional but rapid development RESTful API framework based on Struts2 and Spring

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.downgoon:jresty:jresty-0.0.1'
	}

	dependencies {
		implementation("com.github.downgoon:jresty:jresty-0.0.1")
	}

	<dependency>
	    <groupId>com.github.downgoon</groupId>
	    <artifactId>jresty</artifactId>
	    <version>jresty-0.0.1</version>
	</dependency>


                            
    libraryDependencies += "com.github.downgoon" % "jresty" % "jresty-0.0.1"


                            
    :dependencies [[com.github.downgoon/jresty "jresty-0.0.1"]]

Readme

jresty

jresty-rest-example
jresty-rest
jresty-data-orm
jresty-data-cache
jresty-data-http
jresty-commons
jresty-security

jresty-rest-example

hello-world-jresty: a quick start example

how to run

run in eclipse

org.example.jresty.runner.JettyEmbedRunner
run with maven

// in rd env (development environment) mvn -Djetty.port=8080 jetty:run -Dmaven.test.skip=true -Prd

// in op env (production environment) mvn -Djetty.port=8080 jetty:run -Pop

how to access

multi representation

curl http://localhost:8080/jresty/ping.json -i
curl http://localhost:8080/jresty/ping.jsonp -i
curl http://localhost:8080/jresty/ping.xml -i
curl http://localhost:8080/jresty/ping.html -i
curl http://localhost:8080/jresty/ping.jsp -i

# redirect support for .html|.jsp
http://localhost:8080/jresty/ping.jsp?redirect=http://www.baidu.com
http://localhost:8080/jresty/ping.html?redirect=http://www.baidu.com

two URLs for one method

# GET ping.json is equal to GET ping-index.json
# POST ping.json is equal to GET ping-create.json
# DELETE ping.json is equal to GET ping-remove.json
# PUT ping.json is equal to GET ping-update.json
# GET ping/ABC.json is equal to GET ping-view.json?id=ABC

curl http://localhost:8080/jresty/ping.json -i
curl http://localhost:8080/jresty/ping-index.json -i

some examples

$ curl http://localhost:8080/jresty/ping.json -i
HTTP/1.1 200 OK
Content-Language: zh-cn
Access-Control-Allow-Origin: *
Content-Length: 97
Content-Type: application/json;charset=UTF-8
Cache-Control: max-age=0
Server: Jetty(7.2.0.v20101020)

$ curl http://localhost:8080/jresty/ping.xml -i
HTTP/1.1 200 OK
Content-Language: zh-cn
Access-Control-Allow-Origin: *
Content-Length: 200
Content-Type: application/xml;charset=UTF-8
Cache-Control: max-age=0
Server: Jetty(7.2.0.v20101020)

<io.downgoon.jresty.rest.model.UnifiedResponse>
	<status>200</status>
	<message>OK</message>
	<debug>20161218152559257318:系统正在运行</debug>
</io.downgoon.jresty.rest.model.UnifiedResponse