Remote System Connector - API

A simple interface for your resource adapter providing access to a connection. Your resource adapter api should extend the Connection and ConnectionFactory interface. The connection interface exposes the api of your remote system.

License	The Apache Software License, Version 2.0
GroupId	com.java-adventures.rsc
ArtifactId	remote-system-connector-api
Last Version	1.1.0
Release Date	Dec 3, 2013
Type	jar
Description	Remote System Connector - API A simple interface for your resource adapter providing access to a connection. Your resource adapter api should extend the Connection and ConnectionFactory interface. The connection interface exposes the api of your remote system.

Download remote-system-connector-api

Filename	Size
remote-system-connector-api-1.1.0.pom
remote-system-connector-api-1.1.0.jar	2 KB
remote-system-connector-api-1.1.0-sources.jar	2 KB
remote-system-connector-api-1.1.0-javadoc.jar	39 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.java-adventures.rsc/remote-system-connector-api/ -->
<dependency>
    <groupId>com.java-adventures.rsc</groupId>
    <artifactId>remote-system-connector-api</artifactId>
    <version>1.1.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.java-adventures.rsc/remote-system-connector-api/
implementation 'com.java-adventures.rsc:remote-system-connector-api:1.1.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.java-adventures.rsc/remote-system-connector-api/
implementation ("com.java-adventures.rsc:remote-system-connector-api:1.1.0")

Apache Buildr

'com.java-adventures.rsc:remote-system-connector-api:jar:1.1.0'

Apache Ivy

<dependency org="com.java-adventures.rsc" name="remote-system-connector-api" rev="1.1.0">
  <artifact name="remote-system-connector-api" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.java-adventures.rsc', module='remote-system-connector-api', version='1.1.0')
)

Scala SBT

libraryDependencies += "com.java-adventures.rsc" % "remote-system-connector-api" % "1.1.0"

Leiningen

[com.java-adventures.rsc/remote-system-connector-api "1.1.0"]

Dependencies

provided (1)

Group / Artifact	Type	Version
org.glassfish.main.extras : glassfish-embedded-all	jar	3.1.2.2

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.11
org.mockito : mockito-all	jar	1.9.5

Project Modules

There are no modules declared in this project.

#outbound-connector

A base implementation of an outbound-connector that uses the connection properties url, username and password.

This project comes with:

• A base connector api
• A base connector implementation
• Sample echo connectors consisting out of
  • echo connector api
  • echo connector implementation
  • extended connector with additional config parameter
• Demo REST applications that uses different instances of the echo connectors

This project demonstrates how easily new external system can be accessed in your applications. The major achievement of the connector approach is that connectivity information like url and password are configured at container level and not at application level like your war or ejb-jar. The developer of the business logic does not have to care about the connection and it's configuration exactly as it's done with JDBC connections.

This project is still work in progress. More features will follow.

##Build and deploy

###Glassfish

Build: mvn clean install

Deploy: examples/urlbased/echo/deployResourceAdapter.sh glassfish

Undeploy: ./undeployResourceAdapter.sh glassfish

###JBoss/Wildfly

Build:

mvn clean install

Deploy:

export JBOSS_HOME=...
examples/urlbased/echo/deployResourceAdapter.sh jboss

Undeploy:

examples/urlbased/echo/undeployResourceAdapter.sh jboss    

##Test

./test1.sh
./test2.sh

or

http://localhost:8080/demo-app/rest/echo/HelloWorld
http://localhost:8080/demo-app/rest/echo2/HelloWorld

Versions

Version
1.1.0 Dec 3, 2013