Change Log

Version 0.90.1:

• Fixed XdrEncodingStream.xdrEncodeByteFixedVector() which falsely encoded length information about the following array of characters. I should take more care when doing "Italian code recycling" using copy & pasta...
• Fixed bug in OncRpcTcpClient.call() which caused XDR buffer underflows when receiving the next reply after the previous reply has been rejected by an ONC/RPC server.
• Updated package.html for package org.acplt.oncrpc to put it in sync with (de-) serializing fixed-size vectors and dynamic and fixed vectors of characters.
• Added AUTH_UNIX authentication. For this to achieve quite some additions and changes were necessary -- luckily, old applications will not be broken, as the changes are deep within the RemoteTea package:
  • See OncRpcClient for a description about how to use authentication with ONC/RPC clients.
  • For handling of client-side authentication issues, the classes OncRpcClientAuth, OncRpcClientAuthNone and OncRpcClientAuthUnix were added.
  • The ONC/RPC call and reply message classes OncRpcReplyMessage and OncRpcCallMessage are now both abstract. This was necessary because ONC/RPC protocol issues make it necessary to handle authentication through so-called authentication protocol handling objects different on the client side than on the server side. Additional classes now handle sending calls and receiving replies on the client side (OncRpcClientCallMessage and OncRpcClientReplyMessage respectively), as well as on the server side (OncRpcServerCallMessage and OncRpcServerReplyMessage). According to their needs, these new classes only declare those encoding and decoding methods which are really needed. In consequence, the base class OncRpcCallMessage has lost its XdrAble interface completely.
  • Added authentication handling and credential refreshing to OncRpcUdpClient and OncRpcTcpClient, as well as to the base class OncRpcClient.
  • Added authentication protocol handling to ONC/RPC transports. If servers want to take advantage of authentication, they need to look at the callMessage.auth attribute of the OncRpcCallInformation delivered with each incomming ONC/RPC call. See tests.org.acplt.oncrpc.ServerTest.java for an example.
  Please note that AUTH_DES is still not supported, as this needs quite some things to be done and I don't have full information about the AUTH_DES protocol.
• Added new classes XdrBufferEncodingStream and XdrBufferDecodingStream for encoding and decoding XDR data from and to a fixed-size buffer. These classes comes in handy when dealing with shorthand credentials.
• Added class XdrDynamicOpaque to handle variable-sized vectors of bytes.
• Moved the jrpcgen package to org.acplt.oncrpc.apps.jrpcgen, because it's an application belonging very tight to ONC/RPC.
• Added new OncRpcConstants.REMOTETEA_VERSION_PREVERSION, which indicates preversions if not zero.

Version 0.86.1:

• As Sun's rpcgen encodes char<> as a series of characters, each one sitting happily in its very own XDR int (that is, four bytes), the two methods XdrDecodingStream.xdrDecodeBytes() and XdrEncodingStream.xdrEncodeBytes() were renamed to XdrDecodingStream.xdrDecodeByteVector() and XdrEncodingStream.xdrEncodeByteVector() as well as their semantics changed accordingly.
• Added methods XdrDecodingStream.xdrDecodeDynamicOpaque(), XdrEncodingStream.xdrEncodeDynamicOpaque(), XdrDecodingStream.xdrDecodeByteFixedVector() and XdrEncodingStream.xdrEncodeByteFixedVector().
• Fixed jrpcgen accordingly, so it generates proper code for arrays of bytes and opaque data types accordingly.
• Made all non-abstract encoding and decoding methods in XdrDecodingStream and XdrEncodingStream finally final. Maybe this helps Java compilers improve code speed. Maybe.
• Fixed jrpcgen code generation error when the size of an array was specified using a constant identifier. Now jrpcgen properly references the constant from the x-file's main class.
• Fixed some documentation errors for XdrDecodingStream and XdrEncodingStream.

Version 0.85.1:

• Added new method readBuffer() to class XdrTcpDecodingStream. This fixes problems when reading from a TCP/IP stream and not all bytes wanted are immediately available, thus stream.read() returning not all bytes at once (shame on me for not reading the java.io documentation attentive enough).

Version 0.84.1:

• Added control over the retransmission strategy used by UDP/IP-based ONC/RPC clients. The default strategy is now not to resend lost ONC/RPC calls (retransmission timeout is set to the overall timeout). Either a fixed retransmission timeout can be choosen, where lost calls are resend every <retransmission timeout> milliseconds, or an exponential back-off alogorithm. The exponential scheme starts with the retransmission timeout and doubles it every time a call is lost, until the overall timeout is reached.
• Added two more constructors to ONC/RPC clients generated by jrpcgen from x-files. These constructors now also accept the remote program number, so application writers gain full control.

Version 0.83.1:

• Fixed support for indirection in decriminated unions. Also cleaned up some minor things related to constants and enumerations. Thanks to Ulrik Sandberg for throwing all kinds of vicious x-files at jrpcgen.

Version 0.82.1:

• Added support for indirection in x-files, also called "optional data" in ONC/RPC babble. Also added a new test case to the demo.x file.

Version 0.81.1:

• Added broadcasting of ONC/RPC calls to UDP/IP-based ONC/RPC clients through the new broadcastCall of method in class OncRpcUdpClient.
• Added helper methods for encoding and decoding fixed-size vectors for various base data types.
• Added a description about mapping rpcgen (RFC 1832) data types to Java data type.
• Added an RPC protocol compiler named jrpcgen. Sun's documentation on the rpcgen syntax and grammar is rather thin and sometimes inaccurate. As always, I had to resort to RTSL ("Read The Source, Luke!") to find out what syntax and grammar rpcgen does in fact use. Please give it a try and report problems. Note that there is no preprocessor step.

Version 0.80.2:

• Fixed a buffer underflow exception in XdrUdpDecodingStream in methods xdrDecodeOpaque(int) and xdrDecodeOpaque(byte[],int,int). This cures the bug where a XDR string being the last piece of information in a RPC call or reply could not be read successfully.
• Added org.acplt.oncrpc.OncRpcConstants, which contains versioning information.

Version 0.80.1:

• Separated the ONC/RPC package under the name "Remote Tea" from the ACPLTea package. As the ONC/RPC implementation is pretty functional the version number was changed to reflect this.
• Added XDR primitive and serializable data types for strings, floats, etc.

Version 0.35.1 and before:

• Graciously hidden in the mist of history (probably also in the midst of history). The Remote Tea package was then only available together with the ACPLTea package but not separate.