brutusin / brutusin-rpc Goto Github PK

View Code? Open in Web Editor NEW

39.0 6.0 11.0 1.39 MB

Self-describing JSON-RPC web services over HTTP, with automatic API description based on JSON-Schema

Home Page: http://demo.rpc.brutusin.org

License: Apache License 2.0

Java 94.69% JavaScript 5.22% Shell 0.09%

websockets microservices http spa single-page-applications java spring json json-schema json-rpc2

brutusin-rpc's Introduction

Brutusin-RPC

JEE web framework for creating self-descriptive JSON-RPC microservices and single-page applications with minimal effort.

Features

JSON-RPC 2.0 over HTTP
JSON-RPC 2.0 over websockets
Messaging (publish/subscribe) over websockets
Java & Javascript client API
Builtin descriptive services and functional testing module
Arbitrary complex input and output description based on JSON Schema
Spring-security integration
Embedded server runtimes

Full Documentation

See the Wiki for full documentation, examples, operational details and other information.

Quick start. Code and test!

Run this java application:

import org.brutusin.rpc.Server;
import org.brutusin.rpc.websocket.WebsocketAction;

public class HelloAction extends WebsocketAction<String, String> {

    @Override
    public String execute(String input) throws Exception {
        return "Hello " + input + "!";
    }

    public static void main(String[] args) throws Exception {
        Server.test(new HelloAction());
    }
}

and automatically your browser will be open with a functional testing client for the newly created service:

Live demos

http://demo.rpc.brutusin.org
http://secure.demo.rpc.brutusin.org (see here needed credentials)
http://chat.demo.rpc.brutusin.org

Support, bugs and requests

https://github.com/brutusin/Brutusin-RPC/issues

Authors

Ignacio del Valle Alles (@idelvall)

Contributions are always welcome and greatly appreciated! Just fork, and send me a pull request.

License

Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0

brutusin-rpc's People

Contributors

Stargazers

Watchers

Forkers

jbravo chaabni mantoniocc marcusaram jumarome damozhiying billthebest lightning-pro ibrahim-elsakka arteapartedelarte sokolov43

brutusin-rpc's Issues

requests server->client (and receive responses)

Can we?

Something like
https://github.com/Kurento/kurento-java/blob/master/kurento-integration-tests/kurento-jsonrpc-test/src/test/java/org/kurento/jsonrpc/test/BidirectionalMultiTest.java

functional test module

When resolving schemas via websockets, if there connection is closed, reload the page

Support different programming models

Current service implementation is based on strategy pattern extending different framework base action classes.
It would be great to support other programming models that allow to instantiate services by other means (for example annotated methods in a class)

Suggested by @bessemHmidi

Validation is not working if form is not filled

Hi ,
I am using brutusin:json-forms in my project to create form dynamically. But I have found one issue with validation. If form is empty then validation is not working for below json
JSON Data=>
{
"title": "Person",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"age": {
"description": "Age in years",
"type": "integer",
"minimum": 0
}
},
"required": ["firstName", "lastName"]
}

Please help me to fix this issue.

add support for async operations

For blocking operations performed in the action for example in DelegatingHttpAction it would be great being able of setting the action as "async" and executing it in a aync context by the RPCServlet https://docs.oracle.com/javaee/7/tutorial/servlets012.htm

Document Java client API

[rpc-repo] File inputs not rendered in Safary 6

[rpc-repo] showList() do not updates url hash

go to a service detail and click main logo

NPE when running Server.test()

In TomcatRuntime lines 178 and 235.

Unexpected end-of-input: for file uploads

"Unexpected end-of-input: was expecting closing quote for a string value\n at [Source: {"jsonrpc":"2.0","params":{"image":"BrutusinForms; line: 1, column: 99]"

When using the MetaDataInputStream I am getting the above error.

I also cannot access the URL's from the http://demo.rpc.brutusin.org/rpc/repo/#http-services/upload pages

Thanks
Rob

[rpc-repo] blob ajax response not working in Safary 6

http://demo.rpc.brutusin.org/rpc/repo/#http-services/logo

Document action delegation

Put Spring dependencies out of the main modules (rpc_impl, rpc_api)

In order to support different container implementations (CDI, Spring, ...) main modules must not depend on any Spring artifact.

Suggested by @bessemHmidi

no id in rpc response

Hi,

I am testing a simple use case and have found no "id" field in my response !
Am I doing something incorrect in my implementation ?

Thanks

Help! Exception while running as Jar

Exception sending context initialized event to listener instance of class org.brutusin.rpc.RpcInitListener
java.lang.NullPointerException
at org.brutusin.rpc.RpcInitListener.initWebsocketRpcRuntime(RpcInitListener.java:75)
at org.brutusin.rpc.RpcInitListener.contextInitialized(RpcInitListener.java:44)
at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4738)
at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5181)

getSourceCode() not working for shaded jars

code at: https://github.com/brutusin/Brutusin-RPC/blob/master/rpc-api/src/main/java/org/brutusin/rpc/RpcComponent.java#L103

example: http://localhost:8080/rpc/repo/#http-services/rpc.http.version

OpenRPC Integration

First of all, wicked project. Great to see others are building nice tools for JSON-RPC.

I was wondering if you've given any thought to integrating OpenRPC into brutusin-rpc? There is certainly a lot of ways in which they could benefit each other. https://open-rpc.org is the website for it.