JbyJ
Nov.09.2007
 



What is JbyJ

JbyJ is a plug-in for 4D. It enables followings:

1
JbyJ enables 4D to connect to other 4D in a network and call its project methods.
2
JbyJ enables Java programs to connect to 4D in a network and call its project methods.

It is possible to call project methods mutually regardless of 4D versions(v6.0-v11) and regardless of 4D application types(mono-4D, 4D Server, 4D Client). And the project methods can be called from Java applications, applets, servlets, JSPs in a network.

JbyJ requires the setup of Java environments because it uses Java RMI (Remote Method Invocation).

RMI: http://java.sun.com/products/jdk/rmi/


JbyJ Files

JbyJ consists of following files besides the plug-in file.

JbyJ_xxx.jar
This file is a Java archive file which is located in RonriKobo folder.
JbyJClasses_xxx.jar
This file is a class library to develop Java programs which connect to 4D and call the project methods.
JbyJAdaptor_xxx.jar
JbyJAdaptor_xxx.jar is a servlet. It behaves as a mediator between RMI and HTTP protocols.

Note: In JbyJ version 4.0.1 or later, JbyJ_xxx.jar and JbyJAdaptor_xxx.jar are located at Plugins/JWorld_xxx.bundle/Contents/RonriKobo.


Classification

JbyJ is classified into JbyJ STD and JbyJ PRO.

JbyJ STD
4D plugged JbyJ STD can accept connections from other 4D. But it cannot accept connections from any Java programs.
JbyJ PRO
4D plugged JbyJ PRO can accept connections from other 4D like JbyJ STD. In addition, it can accept connections from Java programs (JSP, servlet, applet, application and so on), which are developed by using JbyJClasses_xxx.jar.

System requirements

JbyJ works with 4th Dimension, 4D Server v 6.0.6 or later in Mac OS and Windows.

JbyJ cannot work with v2004 or earlier versions of 4D on Intel-based Macs, because it cannot work in Rosseta. On Intel-based Macs, you need to use JbyJ ver 4.1.1 or later with 4D v11 or later.

In Windows JbyJ requires a Java virtual machine from Sun Microsystems.


Java virtual machine ( JVM )

JbyJ requires a Java virtual machine (JVM) to run. The Java virtual machine is launched by JWorld which is another 4D plugin.

IIn Mac OS X, JbyJ uses the built-in JVM.

In Windows, JbyJ requires Sun's J2SE(Java2 Platform Standard Edition) . You can download the latest J2SE at the following URL.

http://java.sun.com/javase/downloads/


Protocols for JbyJ

JbyJ uses the RMI protocol to communicate with other 4D. However this protocol cannot be used by some of firewalls.

In order to connect to other 4D, JbyJ has two plug-in methods "JbyJ Connect server" and "JbyJ Connect server by servlet". The former uses RMI only, the latter uses HTTP (or HTTPS) between the source 4D and the HTTP server, and then uses RMI between the HTTP server and the destination 4D. In the latter case, the servlet JbyJAdaptor_xxx.jar must be used as a mediator between the two protocols. It works with a servlet container like Jetty or Tomcat. The HTTP server and the destination 4D may be located in a computer or in two computers in a network individually. In the demos for JbyJ, Jetty is used as a HTTP server and servlet container.

Jetty: http://jetty.mortbay.org/


Documentation


 
Copyright (c) Ronri Kobo, Inc. All rights reserved.
support@ronri-kobo.com