Wiki source code of Remoting Home
Version 5.1 by christoph_lechleitner@iteg_at on 2022-05-30 02.40:38
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
| |
3.1 | 1 | = {{id name="RemotingHome-Introduction"/}}Introduction = |
| 2 | |||
| |
2.1 | 3 | Remoting is a framework issuing remote calls over TCP/IP with optional TLS support. It provides for callback patterns, broadcating and bean support and interoperates well with the [[spring framework>>url:http://www.springframework.org/||shape="rect"]] and [[OSGi>>url:http://www.osgi.org||shape="rect"]]. |
| |
1.1 | 4 | |
| |
2.1 | 5 | Furthermore, it offers two alternative wire protocols. One is based on java.io.ObjectOuputStream while the other protocol uses a highly optimized binary data stream, which additionally features C++ interoperability through the fancysock library. |
| |
1.1 | 6 | |
| |
2.1 | 7 | The source code can be checked out from the SVN repository located here: |
| |
1.1 | 8 | |
| |
2.1 | 9 | {{code language="none"}} |
| 10 | http://svn.clazzes.org/svn/remoting | ||
| 11 | {{/code}} | ||
| |
1.1 | 12 | |
| |
2.1 | 13 | For manual installation you may download the .jar files from the maven repository: |
| |
1.1 | 14 | |
| |
2.1 | 15 | {{code language="none"}} |
| 16 | http://maven.clazzes.org/org/clazzes/remoting/ | ||
| 17 | {{/code}} | ||
| |
1.1 | 18 | |
| |
3.1 | 19 | = {{id name="RemotingHome-Mavenintegration"/}}Maven integration = |
| |
2.1 | 20 | |
| 21 | We recommend to build your project with [[Maven>>url:http://maven.apache.org/||shape="rect"]]. Just add the following snippets to your {{code language="none"}}pom.xml{{/code}} file: | ||
| 22 | |||
| 23 | {{code language="none"}} | ||
| 24 | <repository> | ||
| 25 | <id>clazzes.org</id> | ||
| 26 | <url>http://mvn.clazzes.org/</url> | ||
| 27 | </repository> | ||
| 28 | |||
| 29 | <dependency> | ||
| 30 | <groupId>org.clazzes</groupId> | ||
| 31 | <artifactId>remoting</artifactId> | ||
| 32 | <version>yourversion</version> | ||
| 33 | </dependency> | ||
| 34 | {{/code}} | ||
| 35 | |||
| |
3.1 | 36 | = {{id name="RemotingHome-Sourcecodeandissuetracker"/}}Source code and issue tracker = |
| |
2.1 | 37 | |
| |
5.1 | 38 | --Subversion: [[http:~~/~~/svn.clazzes.org/svn/remoting>>url:http://svn.clazzes.org/svn/remoting||shape="rect"]]-- |
| |
3.1 | 39 | |
| |
5.1 | 40 | --Jira: [[REMOTING>>url:https://jira.clazzes.org/browse/REMOTING||shape="rect"]]-- |
| |
3.1 | 41 | |
| |
5.1 | 42 | Git-Mirrors: See [[https:~~/~~/git.clazzes.org/>>url:https://git.clazzes.org/||shape="rect"]], search for "{{code language="none"}}java-libs/rpc{{/code}}". |
| 43 | |||
| 44 | = {{id name="RemotingHome-ProtocolandClient/ServerSupport"/}}Protocol and Client / Server Support = | ||
| 45 | |||
| 46 | == {{id name="RemotingHome-BinaryProtocol"/}}Binary Protocol == | ||
| 47 | |||
| 48 | The binary protocol that is based on but not quite equal to Java serialization. | ||
| 49 | |||
| 50 | Both Java and C++ can act as client and server for this variant. | ||
| 51 | |||
| 52 | === {{id name="RemotingHome-BinaryProtocolC++"/}}Binary Protocol C++ === | ||
| 53 | |||
| 54 | For C++ see {{code language="none"}}fancysock3-dev{{/code}} from the {{code language="none"}}*-fancylibs-3{{/code}} repos on [[deb.clazzes.org>>url:https://deb.clazzes.org/||shape="rect"]] and [[rpm.clazzes.org>>url:https://rpm.clazzes.org/||shape="rect"]]. | ||
| 55 | |||
| 56 | As as starting point look at class {{code language="none"}}Fancy::Sock::RemotingConnectionHandlerFactory{{/code}} (server) and {{code language="none"}}Fancy::Sock::RemotingClientPool{{/code}} (client). | ||
| 57 | |||
| 58 | == {{id name="RemotingHome-JSONProtocol"/}}JSON Protocol == | ||
| 59 | |||
| 60 | The JSON protocol is based on JSON-RPC-2.0 and supported by a server helper for C++, and there are examples for JavaScript clients (but nothing public yet). | ||
| 61 | |||
| 62 | === {{id name="RemotingHome-JSONProtocolC++"/}}JSON Protocol C++ === | ||
| 63 | |||
| 64 | For C++ see {{code language="none"}}fancysock3-dev{{/code}} from the {{code language="none"}}*-fancylibs-3{{/code}} repos on [[deb.clazzes.org>>url:https://deb.clazzes.org/||shape="rect"]] and [[rpm.clazzes.org>>url:https://rpm.clazzes.org/||shape="rect"]]. | ||
| 65 | |||
| 66 | As as starting point look at class {{code language="none"}}Fancy::Sock::HttpD::JsonRpc2RequestHandler{{/code}}. | ||
| 67 | |||
| 68 | === {{id name="RemotingHome-JSONProtocolJavaScript"/}}JSON Protocol JavaScript === | ||
| 69 | |||
| 70 | There is no public example from clazzes.org yet, but it's basically JSON-RPC-2.0. | ||
| 71 | |||
| 72 | \\ | ||
| 73 | |||
| 74 | \\ |