Version 0.1

Date: 31 July 2008

Archive: version 0.1

Initial release (beta). Targets SAMP WD v1.0 (25 June 2008).

Version 0.2

Date: 19 September 2008

Archive: version 0.2

Code reorganisation and pluggable XML-RPC implementation:

The XML-RPC and Standard Profile-related parts of the library have been reorganised somewhat. A new package org.astrogrid.samp.xmlrpc ant its descendants now hold all the code which relates specifically to XML-RPC communications and the SAMP Standard Profile; the code in the other packages is profile-agnostic and handles only transport-independent aspects of the protocol. The xmlrpc package itself defines a pluggable interface for providing XML-RPC client and server functionality; two implementations are also provided, in the packages xmlrpc.apache and xmlrpc.internal. The Apache one is basically what was there in previous versions; the internal one is completely freestanding, and if this is used the Apache XML-RPC library is not required for operation.

GUI functionality added

There are more classes in the org.astrogrid.samp.gui package to facilitate high-level use of SAMP within GUI applications. ConnectorGui provides Actions suitable for insertion in a general SAMP control menu, and SendActionManager provides menus and Actions for sending particular messages.

New command snooper:

Logs received messages to the terminal. Useful for debugging.

Minor changes:

• Moved some GUI functionality from client.HubConnector to gui.ConnectorGui.
• HubClient privateKey member is now an Object not a String, for greater generality.
• RegInfo(String,String,String) constructor withdrawn.
• HubRunner class moved from package hub to xmlrpc.
• Several other more or less minor changes.

Version 0.2-1

Date: 25 September 2008

Archive: Version 0.2-1

Bugfixes:

• Fixed a problem with XML-RPC implementation when running in presence of unexpected (not 1.2) version of Apache XML-RPC library.
• jsamp.xmlrpc.impl property now correctly propagated to JVM running external hub.
• Race condition in unit tests which sometimes gave false failures is fixed.
• Fixed threading problem in hubmonitor which meant that sometimes window did not appear.
• Some other minor items.

Version 0.3

Date: 9 December 2008

Archive: Version 0.3

Major New Features:

• There is now an option for both hub and client GUI to keep track of and display messages which have been sent. HubRunner and HubMonitor GUIs by default now have tabs showing messages sent/received and their current status - see GUI Features section for some screenshots. To see this in action, start the HubRunner in (default) msg-gui mode and then run HubTester. Or just use the hub with your own SAMP clients. Note that this functionality incurs some overhead - if not used no such overhead is incurred.
• A new small GUI component is available which just shows the icons for all registered clients (like what used to appear in the bottom right corner of VODesktop windows).
• Facilities have been added for full logging of all XML or RPC communications in the hub or clients. See new xml-log and rpc-log options to -xmlrpc flags of command-line tools, and classes org.astrogrid.samp.xmlrpc.internal.*LoggingInternal*.
• Replace DefaultSendActionManager with other, more capable, SendActionManager subclasses. This makes it easy to handle the results from messages which have been sent, for instance by passing the information to the user graphically or in other ways.
• HubMonitor tool can now subscribe to messages other than administrative ones, like Snooper.
• MessageSender tool now pretty-prints response(s).

Backwards Compatibility:

There have been a number of changes since release 0.2 which are backwardly incompatible, so that source code using earlier versions of JSAMP will need to be adjusted. GUI-related functionality is most affected. This is because I'm still designing it, and some changes were required to accommodate new features etc; sorry. I hope that there will be fewer backwardly incompatible changes in the future as the library matures - but I'm not offering any guarantees just yet. Some of the more obvious changes are as follows:

• New class gui.GuiHubConnector now contains the Swing-related functionality which was previously in (its superclass) client.HubConnector, and also all the functionality from the now removed class gui.ConnectorGui.
• HubRunner and ConnectorGui APIs modified to permit use of various different hub implementations (with different graphical characteristics - see HubMode).

If there are things which used to work in a previous version and you can't see how to do it now, please contact me and I'll advise how to update.

Bugfixes:

• Fixed server error which sometimes resulted in failed reads, especially for long messages.
• Fixed error in handling CalcStorm -xmlrpc flag.

Other:

• Change return values of callAll and notifyAll hub methods as per agreed modifications to the standard at version 1.1. Affects hub and client API, implementation and test suite.
• Default XML-RPC implementation is now Internal rather than Apache.
• HubConnector now subscribes to samp.hub.disconnect MType.
• Improved performance of internal client when sending long messages.
• Add SampUtils.isSampChar() convenience method.
• Add public createTag method to HubConnector.
• Added test for long messages in HubTester.
• HubTester now tests nearly all legal SAMP string characters.
• ...And some other things not mentioned here.

Version 0.3-1

Date: 27 March 2009

Archive: Version 0.3-1

Minor Enhancements:

• Add GuiHubConnector.createRegisterOrHubAction method, which registers if it can, else offers the user to start a hub. This may be the only button you need.
• Internal HTTP server now tolerates LF as well as the correct CRLF as HTTP request header line terminators, as recommended by HTTP 1.1 (RFC2616).
• Add convenience methods call and callAll to HubConnector - these allow you to make asynchronous calls so that the results are delivered as callbacks to supplied objects without having to worry about registering handlers and matching tags.
• Add createTargetSelector/createTargetAction methods to SendActionManager class. These give another way (button plus combo box) go allow users to trigger a send.
• Add comment to .samp lockfile noting that contact XML-RPC URL hostname is configurable.
• Cache home directory when first determined in SampUtil.

Backward Compatibility:

• Moved HTTP server implementation used by internal XML-RPC implementation into its own package, samp.httpd. Also added some utility classes in that package to facilitate serving dynamic resources and resources from the classpath. This is because having a simple self-contained HTTP server may be useful for client implementations doing SAMP-like things other than strictly communicating with the hub.
• ResultHandler and LogResultHandler classes moved from package gui to client.
• Changed SAMP protocol version to 1.11.

Bug Fixes:

• Fixed hub lockfile location bug for Windows at Java 1.4.
• Fix process handling bug which caused Windows XP external hub start to write incomplete lock file.