nmote-xr

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #android #machine-learning #rust #docker #java #windows #awesome #cli #vue #pytorch #security

(★ 10)

Nmote Java XML-RPC client server library

nmote-xr Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

nmote-xr - Simple (X)ML-(R)PC library
=====================================

Java 1.5+ client and server implementation of XML-RPC protocol.
See http://en.wikipedia.org/wiki/XML-RPC

Features
--------
* Supports Java 1.5+
* Reflective and programmable calls
* Basic springframework integration
* No external dependencies at all
* Server and client support
* BSD style license

Add to Your's Project
---------------------

If you use maven for dependency management, add following snippet to pom.xml:

```xml
	<dependencies>
		...

<dependency>
			<groupId>com.nmote.xr</groupId>
			<artifactId>nmote-xr</artifactId>
			<version>2.2.0</version>
		</dependency>

</dependencies>
```

Building
--------
To produce nmote-xr.jar you will need apache maven installed. Run:

> mvn clean package

Usage
-----

* Call userland service

```java
	Endpoint server = XR.client(new URI("http://betty.userland.com/RPC2"));
	MethodCall call = new MethodCall("examples.getStateName", 3);
	MethodResponse response = server.call(call);
	System.out.println(call + " => " + response);
```

* Same as above, but use type safe interface 'Betty'

```java
	interface Betty {
		@XRMethod("examples.getStateName")
		public String getStateName(int n);
	}

Betty betty = XR.proxy(new URI("http://betty.userland.com/RPC2"), Betty.class);
	String result = betty.getStateName(41);
	System.out.println(result);
```

* There is also a `com.nmote.xr.Meta` interface to support rudimentary reflection of XML-RPC

```java
		Meta xrs = XR.proxy(new URI("http://betty.userland.com/RPC2"), Meta.class);
		System.out.println(xrs.listMethods());
```

* To expose a simple XML-RPC HTTP server, you don't need no external dependencies

```java
	@XRMethod(value = "example.helloWorld", help = "Returns 'Helo ' + argument")
	public static String hello(Object s) {
		return "Hello '" + s + "'";
	}

public static void main(String[] args) throws Exception {
		NanoServer server = new NanoServer("http://localhost:7070");
		server.add(XR.server(HelloWorldServer.class));
		server.start();
	}
```

* You can trace XML-RPC calls through LoggerAdapter. Configuration is made through
  EndpointBuilder::debug builder method

```java
		String url = "http://www.cookcomputing.com/xmlrpcsamples/math.rem";
		Math m = EndpointBuilder.client(url, Math.class).debug().get();
		System.out.println(m.add(2, 3));
```

To use your's logging framework of choice instead of System.err, implement
com.nmote.xr.log.LoggerAdapter interface.

* For production you will need to expose `com.nmote.xr.Endpoint` via one or  more
  `com.nmote.xr.XRServlet` instances. Endpoint handling client's request is passed
  in either as a servlet request attribute or a servlet context attribute named
  'com.nmote.xr.Endpoint'. Attribute name can be configured through a servlet
  parameter 'endpointKey'.

Add following snippet to web.xml:

```xml
  	<servlet>
		<servlet-name>xml-rpc</servlet-name>
		<servlet-class>com.nmote.xr.XRServlet</servlet-class>
		<init-param>
			<param-name>endpointKey</param-name>
			<param-value>My-XMLR-RPC-Server-Name</param-value>
		</init-param>
	</servlet>
```

You can also override XRServlet::getEndpoint() to expose service:

```java
		@Override
		protected Endpoint getEndpoint(HttpServletRequest request) throws ServletException {
			class Server {
				@XRMethod
				public String hello(Object s) {
					return "Hello '" + s + "'";
				}
			}

return new ObjectEndpoint().export(new Server(), null);
		}
```

(See the https://github.com/vnesek/nmote-xr/blob/master/src/main/java/com/nmote/xr/XRServlet.java source for more info)

* Package `com.nmote.xr.spring` has support classes for exposing clients and
  server using springframework contexts.

Author Contact and Support
--------------------------

For further information please contact
Vjekoslav Nesek (vnesek@nmote.com)

nmote-xr

nmote-xr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

nmote-xr

nmote-xr Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README