![]() |
ingenieurbuero fuer innovative informationstechnikDipl.-Ing. Joerg Beckmann |
|||||||||
![]() Introduction Installation Configuration Programming License Contact |
Programmer's Guide
|
|||||||||
ContentIntroductionThe RMI InterfaceThe TCP/IP InterfaceCommands of the TCP/IP serverError MessagesExpressionsGuide for Java programmersIntroductionTo connect clients to the iiitAccessServer, the server two has two interfaces. For applications written in Java a RMI interface exits, while other application may talk to the using a TCP/IP socket. Both interfaces are described in following sections. The RMI InterfaceApplications written in JAva may talk to the iiitAccessServer
using RMI. This method has the advantage, that there is a ready-to-use
client library, which implements in addition to the pure communication a
local cache. As a very simple example of a RMI client, you may look
at To create Java clients, the binary packages includes a client library named
The classes the RMI interface consists of are described in detail in the Guide for Java programmers. The TCP/IP InterfaceApplications not written in Java can use the TCP/IP interface to talk to the iiitAccessServer. With a simple protocol and an also simple command language commands can be sent to the server and responses can be received. When opening the socket, the iiitAccessServer shall greet you with a message like: iiitAccessServer - For help send command "HELP" OK The iiitAccessServer is now ready to receive commands. The different commands will described below in separate chapters. Every command will be answered with a result if there is one and a line with the content OK or with an error message ERROR <number>: <message text> All possible error messages are also described below. After the response has been finished with Commands of the TCP/IP serverThe following commands are defined and will be discussed in the next chapters: HELP QUIT SHUTDOWN SETUSER=<user> EXPR=<expression> The server does not distinguish between upper- and lower case. HELPThe command HELP - This help QUIT - Close connection SETUSER=<user> - Set user for expressions EXPR=<expression> - Evaluate expression OK QUITThis command closes the current session. It responses with a short notice: Closing connection This response does not end with SHUTDOWNThe command > telnet localhost 54321 The server responses with short notice like: Closing connection and shutting down This response does not end with SETUSERThe command setuser=joe OK EXPRLast but not least the command setuser=joe OK expr=confirm false OK expr=joe true OK expr=confirm-joe false OK expr=confirm+joe true OK The server responses with Error MessagesAll error messages consist of the key-word Unknown CommandThis error message has the unique number 100. It will be sent if the command could not be recognized. Here are some examples: help=1234 ERROR 100: Unknown command asdf ERROR 100: Unknown command setuser ERROR 100: Unknown command ERROR 100: Unknown command Syntax ErrorThis error message with the number 101 will be returned, if the command line contains syntactical errors. Here are some examples: setuser= ERROR 101: Syntax error a+b ERROR 101: Syntax error a + b ERROR 101: Syntax error a s d f ERROR 101: Syntax error No user setThis error message will be sent if you requested a user right but did not set a current user. The error number is 200. iiitAccessServer - For help send command "HELP" OK expr=confirm ERROR 200: No user set Expression
|
(x + y + z) | A set consisting of the elements x, y, and z. |
(A + B) | The union of the sets A and B. The result will include all elements of the sets A and B. |
(A - B) | The difference of the sets A and B. The result includes all elements of A, which are not included in B. |
(A & B) | The intersection of the sets A and B. The result will include all elements which are included in A and included in B. |
((x + y + z) + A) - (b + e + f) & C | Expression can be grouped with braces. They are resolved from left to right. "&" has a higher priority than "+" and "-". |
Until now, there is no Java programmer's guide but the JavaDoc API Documentation.
![]() |
![]() |
![]() |