Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/giosil/multi-rpc-3
An easy to use library for json-rpc, xml-rpc, SOAP and RESTful/JSONP services implementation.
https://github.com/giosil/multi-rpc-3
json-rpc xml-rpc
Last synced: 10 days ago
JSON representation
An easy to use library for json-rpc, xml-rpc, SOAP and RESTful/JSONP services implementation.
- Host: GitHub
- URL: https://github.com/giosil/multi-rpc-3
- Owner: giosil
- License: apache-2.0
- Created: 2023-11-06T16:36:14.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-05-29T09:29:21.000Z (7 months ago)
- Last Synced: 2024-11-07T06:17:52.202Z (about 2 months ago)
- Topics: json-rpc, xml-rpc
- Language: Java
- Homepage:
- Size: 114 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Multi-RPC-3
An easy to use library for json-rpc, xml-rpc, SOAP and RESTful/JSONP services implementation.
This library use Jakarta Servlet Specification.
## Examples
### Service
```java
import java.security.Principal;
import jakarta.servlet.ServletException;
import org.rpc.server.*;
import org.rpc.util.*;
public class WebRPC
extends RpcServlet {
public void init()
throws ServletException {
rpcExecutor
= new MultiRpcExecutor();
createRpcContex = true;
restful = true;
about = true;
basicAuth = true;
encoding = null; // e.g. "UTF-8", "ISO-8859-1"
addWebService(new Test(),
"TEST",
"Test handler");
}
protected Principal
authenticate(String usr, String pwd) {
if(usr.equals(pwd)) {
return new SimplePrincipal(usr);
}
return null;
}
}
```
### Handler
```java
public class Test {
public String hello(String name) {
return "Hello " + name + "!";
}
}
```
### RESTful call
```
http://localhost:8080/webapp/rpc/TEST.hello/World
```
### JSONP (JSON with Padding) call
```
http://localhost:8080/webapp/rpc/TEST.hello/World?callback=handleResponse
```
### CORS (Cross-Origin Resource Sharing)
```java
public class WebRPC
extends RpcServlet {
// ...
@Override
protected
void doOptions(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
// Response to preflight request
response.addHeader("Access-Control-Allow-Methods", "GET, PUT, POST, DELETE, HEAD, OPTIONS");
response.addHeader("Access-Control-Allow-Origin", "*");
response.addHeader("Access-Control-Allow-Headers", "*");
response.setStatus(HttpServletResponse.SC_NO_CONTENT);
}
@Override
protected
void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
response.addHeader("Access-Control-Allow-Methods", "GET, PUT, POST, DELETE, HEAD, OPTIONS");
response.addHeader("Access-Control-Allow-Origin", "*");
super.doGet(request, response);
}
@Override
protected
void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException
{
response.addHeader("Access-Control-Allow-Methods", "GET, PUT, POST, DELETE, HEAD, OPTIONS");
response.addHeader("Access-Control-Allow-Origin", "*");
super.doPost(request, response);
}
}
```
### JSON serialization / deserialization
```java
import org.json.JSON;
public class Test {
public static void main(String[] args) {
Object data = JSON.parse(args[0]);
System.out.println("JSON.parse -> " + data);
String json = JSON.stringify(data);
System.out.println("JSON.stringify -> " + json);
}
}
```
### Wrapped Collections
```java
import java.sql.Date;
import java.util.HashMap;
import java.util.Map;
import org.util.WMap;
public class Test {
public static void main(String[] args) {
Map map = new HashMap();
map.put("name", "Clark Kent");
map.put("birthdate", "1974-11-19");
List list = new ArrayList();
list.add("3");
Map struct = new HashMap();
struct.put("person", map);
// Wrapped Map
WMap wmap = new WMap(map);
Date date = wmap.getSQLDate("birthdate");
System.out.println("wmap.getSQLDate(\"birthdate\") -> " + date);
// Wrapped List
WList wlist = new WList(list);
int val = wlist.getInt(0);
System.out.println("wlist.getInt(0) -> " + val);
// Wrapped Structure
WStruct wstruct = new WStruct(struct);
String name = wstruct.getString("person.name");
System.out.println("wstruct.getString(\"person.name\") -> " + name);
}
}
```
### Utils and Beans manipulation
```java
import java.util.HashMap;
import java.util.Map;
import org.util.WUtil;
public class Test {
public static void main(String[] args) {
Map map = new HashMap();
map.put("name", "MARIO ROSSI");
Person person = WUtil.populateBean(Person.class, map);
System.out.println(person);
Map mapPerson = WUtil.toMapObject(person, false);
System.out.println(mapPerson);
}
public static class Person {
String name;
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
@Override
public String toString() {
return "name=" + name;
}
}
}
```
## Build
- `git clone https://github.com/giosil/multi-rpc-3.git`
- `mvn clean install`
or
- `mvn -f .\pom-giosil.xml clean install -DcreateChecksum=true`
## Contributors
* [Giorgio Silvestris](https://github.com/giosil)