Jigsaw release notes

Jigsaw 2.1.0

A public release, made on January the 21th, 2000.

This release is a backport of all enhancements that does not deal with XML serialization and also a bufix release.

New Features

• Image metadata extraction
• Servlet.properties parsed at startup
• Charset support
• NoCache filter to deal with broken browsers.

Bug Fixes

• Bug fixed in RealmCatalog and AuthRealm
• internal lookup bug in ProxyFrame
• Fixed bug in the creation of frame arrays
• Fixed an unload notification that was not passed to frames
• Fixed a deadlock in the ResourceStoreManager
• Fixed an extra Content-Type sent in the admin protocol.
• ChunkedInputStream now notifies an EOF if it happens while you ask to read for more bytes than available (was potentially waiting forever before that!)
• Fixed HttpBasicServer, when the client part has to do a two stage HTTP/1.1 request on behalf of a 1.0 client (proxy)
• Fixed ChunkedOutputStream, it is now more optimized and a potential char to byte convertion problem has been removed. Also, the closing of the stream has been fixed.
• Fixed Base64 encoder and decoder, to avoid a potential char to byte conversion error
• Fixed cached entry invalidation, it now marks the entry to be revalidated next time rather than removing it directly from the cache (helps disconnected operation).
• Fixed header update during revalidation not matching 200 or 304 (ex: auth failed)
• modified the attribute name for last modified, as it was interacting badly with revalidations
• JigsawRequestDispatcher in servlet is now cloning the request before an include or a forward
• Fixed MimeType matching
• CacheFilter no longer caches replies with Set-Cookies
• Fixed bug in HttpMessage, The proxy stopped to forward the SetCookie header

Improvements

• Added a more clever (and expensive) loop check in the Proxy, it check for the IP and not for the host only
• Better servlet 2.1 support
• Bettet caching algorithms, (completely redone for 2.1.>0).

Jigsaw 2.1.0

A public release, made on September the 9th, 1999.

This release is the first release using the new serialization scheme. It allows you to change the way the serialization is done. As an exemple, and to provide an easier access to the configuration.

New Features

• New serialization scheme, the current version uses XML, see the JXML format for more information on how to read the serialized files.
• New admin exchange format, using JXML, it allows you to create administration scripts.
• A new upgrader will convert automatically the old Jigsaw stores to the new format, the old stores are kept in a backup directory.

Bug Fixes

• more HttpRange can now be created: "-500","500-", by using -1 as the default value
• The request parser now skip the body if sent directly by the client when an error occured.
• Servlet are destroyed only if all the connections are closed
• Lister in Jigedit now defines the ACTION in the FORM
• Servlet bug fixed in getResource(), thanks to James Clark.

Improvements

• Directory listing now ends the URI of the containers with a "/", preventing an extra redirect
• Logger now has a property to define the logging directory

Limitations

• The jdbmResourceStore has not yet been ported, a consequence is the lack of CacheFilter in the proxy, but it will be replaced soon by a completely new cache.

Jigsaw 2.0.3

A public release, made on July the 27th, 1999.

This release is a bugfix version of the 2.0.2, while 2.1.0 will add new feature and will completely change the way the resources are serialized). Meanwhile, there are new functionalities, like the new Acl api, which replaces the old auth schemes.

New Features

• new Acl API, more flexible than the previous auth scheme.
• Redirecter Frame now handles PATH_INFO.
• Charset and language dialects negotiation.
• Added MimeTypeArray and other basic attributes arrays.

Bug Fixes

• Bad request handling is better, previously, HTTP/1.1 without a Host: header or a full URI was just closing the connection.
• Servlet indexer can now index servlets with full package name
• Bad permission on a file now fires an exception, rather than (possibly) hanging.
• MimeAttribute null balue is now handled in jigadm
• Cache is now sending the right size for null documents
• Servlet's getReader now takes care of the encoding.
• ServletRequest now merges URI parameters and body parameters.
• Fixed ResourceEvent bug (unloaded resources are no longer receiving events)
• Cache is no longer blocking for non-sized multipart documents.
• Fixed loop in proxy when the proxy was on port 80 (fixed also if it is the default https port)
• Fixed timestamp problem when a file has been modified in the past (clock skew is a pain)
• Fixed max-connection and notification of waiting threads during the deletion of an old kept-alive connection
• Cached VaryResource are now checking ETag the right way, no more 304 replies when it was just a cache revalidation.
• Multiple cookies are now sent using multiple headers (ugly but cookies ARE ugly).
• Fixed ResourceStoreManager initialization, when another root resource was set, it may end up in resource duplication and problems while attaching frames/filters, also it was causing deletion loops. WARNING! You may have to redo your configuration if you changed the root resource!
• Fixed servlet timeout unit
• SSI Frame and servlet interaction fixed (no more chunking in that case)
• Logger and port can be changed while the server is running.
• The "No logger" warning is more explicit

Improvements

• Servlet timeout can be disabled
• Servlet cookie maxage can now be -1 (unlimited)
• Language negotiation has been redone, it now check dialects also
• Content negotiation now takes the order into account
• Realms now have a real feeder (administration tool)
• Added bind address so that multiple interfaces can be bound.
• Client garbage collection scheme has been redone, allowing smoother handling of clients when load goes up (it means also better performances)
• MirrorFrame now tweaks also temporary redirects
• Md5 constructor now allows an encoding string.

---

Jigsaw 2.0.2

A public release, made on March the 31th, 1999.

This release includes the first version of the new administration tool (jigadmin, v2). Along with that, numerous improvement over the old version, like servlet API 2.1 support.

New Features

• Digest Authentication
• Http Extension Framework (HttpExtFrame)
• New JigAdmin. This one should be more intuitive than the other, but still, you probably need to understand the design to take best out of it.
• JSDK2.1 (Servlet API) support.
• Per servlet timeout is possible
• JNI port of LibUnix, thanks to Roland Mainz
• New logger ExtendedCommonLogger, doing log rotation and using ECLF format
• *forbid* can be used as a Container index
• Log file resolver, to do DNS resolution offline
• ServletMapperFrame, used to map a file to a servlet (see the FAQ entry about JSP)

Bug Fixes

• HttpChallenge fix, the byte buffer is now recomputed when it changes.
• Redirect fix for virtual hosts
• Relocate fix for virtual hosts
• Frame identifier now used in FrameReference as you may have multiple instances of the same class attached to a resource
• ContentLengthInputStream and ChunkedInputStream now throws an IOException when an error occurs
• 201 Created now generates the right response
• FileAttribute is now sent as a String in the admin protocol to avoid automatic conversion of jdk1.2
• When indexing a file with multiple extensions, frames attirbutes are now aggregated. It requires the use of the new default indexer provided in the distribution, as the Content-Type for modifiers (like .fr) is now set to *none*
• VirtualHost now remove automatically the ":80" added by some robots.
• Extension matching process now does "perfect" match, then case insensitive match if desired.
• CgiFrame has now PATH_TRANSLATED defined
• RedirecterFrame now forward the query string as expected.

Improvements

• index resolution for containers now add Content-Location
• PUT on negotiated resources is handled using ETags
• Users can add environment variable in the CgiFrame configuration
• ETag generation is done in one place, so you can overload it.
• URLDecoder updated to use InputStream AND Readers
• ContentTypeIndexer can now use wildcards (well only *) in its mime type definitions.
• ThreadCache behaviour near the limit is now the right one, also there is a feature to wait for all the thread of the cache.
• PassDirectory can now act as a normal DirectoryResource is the pass-target is not set

---

Jigsaw 2.0.1

A public release, made on January the 18th, 1999.

This release has been done to allow people to use the admin tool despite a JDK1.2 bug. So the fixed bug list is quite short!

Bug Fixes

• Nasty kludge (creation of an useless object) to prevent bug in JDK1.2 classloader
• Garbage collection of old client connection redone.

---

Jigsaw 2.0.0

A public release, made on December the 24th, 1998.

This is the final version of the 2.0 version of Jigsaw. This is a bugfix release of the 2.0beta3.

New Features

• DELETE method implemented both on normal resources and on CVS resources. By default DELETE is not enabled
• New version of JigEdit (documentation pending)
• JDK1.2 fixes, it now compile gracefully with JDK1.2, which means that the usual warnings are thrown.

Bug Fixes

• HttpCacheControl bug on "no-cache"
• Event model for ResourceFrame fixed
• Deleted variants of a Negotiated Frame are now removed from the list of variants
• PageCompile fix for \ under Windows and possible clash on class name.
• getCookies method for Servlets
• NegotiatedFrame throw a 404 if no variant are present (after a delete)
• Servlets called from SSI don't close the stream any longer.
• AdminReader and PlainRemoteResource are now URLEncoding the URIs .
• File system sensitivity check is now working during the lookup.
• First access on some resources may return an error as the parent was not created, now fixed.
• File Descriptor leak fixed on ugly configurations.

Enhancements

Documentation is still evolving, and, as always, feedback welcome!

---

Jigsaw 2.0beta3

A public release, made on October the 2nd, 1998.

This is a bug fix release of the previous 2.0beta2.

New Features

• PageCompilation, allow you to do fancy server side includes
• The ZipIndexer allow you to serve files contained in a zip.
• Port of the LabelBureau
• ServletIndexer allow you to index servlet and remove the .class automatically
• ProxyDispatcher rules editor, and re-parsing of the rules.

Bug Fixes

• Various bug fixes on servlets
• Properties editable directly in JigAdmin (mICP, proxy dispatcher, servlet)
• servlet classloader revamped.
• ProxyFrame lookup bug (inifnite redirect on itself) fixed
• Observable properties now works better.
• Jigadm gives now more feedback during save and such.
• Jigadm crash on latest JDK fixed.
• HTTP/1.1 fixes according to the latest draft-ietf-http-v11-spec-rev-05
• Jigsaw client now reuses connections the right way
• Tons of deadlocks and error recovery added in the internal handling of the cache of the proxy
• getRequestURI now works according to JSDK's api.
• fixes in the ZipDirectory

Enhancements

• The documentation is evolving, but still, constructive comments are welcome!
• JigAdmin GUI gives more feedback. Designers, feel free to work on the GUI!

---

Jigsaw 2.0beta2

A public release, made on July the 10th, 1998.

This is a bug fix release of the previous 2.0beta1.

New Features

• Complete JSDK/2.0 servlet API support. It even includes session tracking.
• Some filters to demonstrate HTTP/1.1 interoperability like the UseProxyFilter.
• HourLimiterFilter, to restrict access during some time.
• Content-Type indexers to use all the Content-Type information given in a PUT.

Bug Fixes

• Broken resources can now be deleted
• Many HTTP/1.1 fixes according to the draft-ietf-http-v11-spec-rev-03.
• Partial Content fixed (it was sending one byte too much)
• Missing Content-Length
• Content-MD5 to ensure end-to-end message integrity check.
• Events within frames and resources now fixed.
• Bug in SSI frame (event related).
• Many Cookies fixes, it is now implementing more things than before.
• Tracking of the "real" root resource.
• some more timeouts to solve the problem of blocked threads
• Fixes in jdbm, to fix the way the buckets were splitted in the cache.
• Virtual Hosting was broken when issuing redirects, now fixed with the creation of a specific resource: VitrualHostResouce.
• Range requests from cached resources now have the real value.

Enhancements

• The documentation! It is not perfect yet, and comments are welcome to improve it.

---

Jigsaw 2.0beta1

A public release, made on April the 8th, 1998.

This is the first complete release of the new Jigsaw, with the new internal design.

Bug Fixes

There was almost no bug fix in the new resource model of Jigsaw, but there was some modification of the HTTP stack, mainly about the handling of the PUT method.

New Features

All the resources of the 1.0beta2 has been ported to the new 2.0 version. This includes:

• RedirecterFrame
• VirtualHostFrame
• CgiFrame
• CvsFrame
• CvsFileFrame
• ToolsListerFrame
• PutListFrame
• PostableFrame
• MapFrame
• ForwardFrame
• ProxyFrame
• PasswordEditorFrame
• CheckpointFrame
• DirectoryListerFrame
• GcStatFrame
• StatisticsFrame
• ThreadStatFrame
• CookieFilter
• HeaderFilter
• LogFilter
• CounterFilter
• DebugFilter
• GZIPFilter
• PutFilter
• CacheFilter
• AccessLimitFilter
• PutSizeFilter
• ErrorFilter
• GrepPutFilter
• ProcessFilter

The new documentation is also more complete.

Incompatible changes

To avoid the name length limit on the Mac, the resource files used by JigAdmin are now stored in a zip, the old version of JigAdmin will not work with this new version, you then need to upgrade both the server and the client to do administration.

---

Jigsaw 2.0alpha1

A public release, made on January the 31th, 1998.

This 2.0 release is the first release of the new internal design of Jigsaw.

Bug Fixes

This version as all the bug fixes of the 1.0beta2 about protocol issues. Other bug fixes have no meaning here as the internals of Jigsaw have been reworked.

Incompatibles changes

• The name of the classes are now org.w3c... instead of w3c...
• The resources are no longer linked with the protocol, protocole frames are added to the raw resources
• The resources are limited, DirectoryResource, FileResource, PassDirectory, FramedResource, ContainerResource and ExternalContainer.
• The new frames are:
  • ProtocolFrame
  • HTTPFrame
  • ResourceFrame
  • NegotiatedFrame
  • RelocateFrame
  • SSIFrame
  • ServletDirectoryFrame
  • ServletWrapperFrame
  • AuthFilter
  • GenericAuthFilter
• The filters are no longer placed on the resource, but on the protocol frame.
• The admin server has been reworked to support framed frames.
• Support for active Resources through listeners. (bean-like event model).
• Modification of the JigAdmin configuration tool to support protocol frames and framed frames.
• The root store of the distribution is no longer needed to start a new server, it creates its own store if none are present.
• The ResourceStoreManager has been completely modified, so the old configurations for the 1.0beta serie will no longer work. You will have to reconfigure your server entirely!
• The form-based configuration is invalid now and has been removed. You MUST use the administration server to configure Jigsaw

New Features

• True reindexing now exists (This is real reindexing rather than deleting the resource).
• Jigsaw will create the root store if not present.
• Installation program that modifies the property files of the servers according to your configuration.
• Partial draft of the new documentation, the next release will have a completely new documentation.

---

Jigsaw 1.0beta2

A public release, made on January the 31th, 1998.

This is a bug fix release of the previous beta release. The purpose of the "beta track" is to improve the stability of Jigsaw. For further developments, see the 2.0 track.

Bug Fixes

• Fixed revalidation mechanism with a no-cache directive.
• The update of a cached resource in case of a revalidation is now correct.
• The Max-Forwards header is now well handled.
• The PUT and POST methods are now working well on HTTP/1.1 servers.
• Fixed a bug in the Via header of proxied resources.
• Fixed default adds of HTTP headers that were wrong.
• debug of the classloader for servlets
• Bug fix in the jdbm enumerator.

Enhancements

• The indexers can now create "ghost" resources to allow more fancy uses of Jigsaw, like shadow icon directories.
• Added the TRACE method of HTTP/1.1
• Added the possibility of templates in the indexers
• the GrepPutFilter forbid a PUT of a document containing a specified string. Very useful when you edit your website from one server and you doesn'y want to allow links to this server.
• Added a DateThread, if you want to speed up Jigsaw a bit (~10% by switching loggers).

---

Jigsaw 1.0beta1

A public release, made on September the 1st, 1997.

This is just a bug fix release of the latest member beta release.

Bug Fixes

• Fixed a bug in Content-Length in case of Chunked encoding.
• Added more feedback when a configuration error occurs while using JigAdmin.
• Fixed bug in the CacheFilter

Enhancements

• Added a new Resource, DirectoryLister, acting like when you access to a directory, useful to make a small index.

---

Jigsaw 1.0beta

A member specific release, made on August the 1st, 1997.

Bug Fixes

• FileResource now supports the HTTP/1.1 If-Range header, and a slight bug was fixed in the emitted Content-Range header
• The HTTP client side cache filter has been fixed (jdbmResourceStore enumration was buggy)
• The Caught Exception trace in errlog has been removed (The trace was the bug - tm)
• Fixed a bug in ICP message parsing (will now correctly handle message of length exceeding 255 bytes)
• If it manages a shared cache, the CacheFilter will no longer cache documents retreive through a request that has an Authorization header.
• Fixed a bug in HTTP Date parsing (one of the three date format wasn't parsed properly)
• Fixed a bug in ContentLengthInputStream (wrong size after an error on a read)
• Fixed a bug in ActiveStream which was the source of empty documents feeded by the proxy.

Enhancements

• Added a property in the ICPFilter to disable caching of documents retreived through ICP
• JSDK/1.0 FCS servlet API support
• Powerful JDBC access through server side include.

  
  This new feature allow you to querty any JDBC compliant database and embed the result within your HTML page. Check the SSIResource api.

• PICS & JDBC.

  
  A new LabelBureau implementation is available. It relies on any JDBC compliant database as the storage mechanism for PICS labels, which makes it more scaleable than the previous filesystem based approach.

• Servlet support has been upgraded to 1.0FCS; Support for automatic servlet reloading has also been implemented (Jigsaw will detect that the servlet class files have changed and will reload them automatically).

New Features

• Added a companion server to do the remote configuration.

  
  The protocol used to communicate with the Admin servlet hasn't been specified yet, and will probably change in the next releases of Jigsaw. The client part of the API (w3c.jigsaw.jigadm.RemoteResource) is unlikely to change though.

• A new graphical tool is available to do the configuration of Jigsaw. Currently, this allows you to do everything the form based editor could do.
• Support for the SAP protocol has been included, as the starting point for multicast proxy-to-proxy support. SAP is the Session Announcement Protocol (an Internet draft)
• The ProxyDirectory resource now supports ftp tunneling (it won't do caching until someone tells me how ftp results can be cached)
• Support for a light multicasted version of ICP now available in the proxy, turn your hundreds of useless 5Mo caches into a usefull 50Mo collaborative proxy: the net is the computer ! Check the MICPFilter client side filter.
• Resource can now be extended through the use of ResourceFrame;

  
  The notion of HTTP filters has proven usefull enough to be extended for non HTTP resources. You can now attach frames to resources that describe users for example (such as the w3c.jigsaw.auth.AuthUser).

Incompatible API changes

• The FormResource constructor now takes a ResourceContext instead of a httpd instance
• The indexing model haa changed quite a bit.

  
  A new indexing model has been designed: each directory can declare how it indexes its content through thew use of its own indexer. The indexer API is defined in w3c.jigsaw.indexer.

Incompatible Configuration Changes

• Filters pickling as attributes

  
  Filters pickling has changed: filters are now just a special resource attribute, and follow the general pickling format. They used to be special, and that caused lots of troubles.
  Don't redefine the pickle method !!

• Cache directory hierarchy

  
  The cache directory hierarchy has been made multi-directory: cached entries are stored in a tree of directories instead of within a single directory (lessen the load on the file system by decreasing the acche directory size)

---

Jigsaw 1.0alpha5

A public release made on February the 13th, 1997.

Incompatible changes

• The AttributeHolder unpickle and unpickleInstance methods, now take a third boolean parameter, that indicates if the resource is to be initialized after unpickling. Warning if you have written an 1.0alpha3 resource that redefines this method, you should make sure to define the new format for this method (since it's the one that gets called by the unpickling engine)
• The HttpReplyMessage setLocation method now takes an URL, to reflect the fact that HTTP/1.1 specification requires an absolute URL here.
• The getURL method of HTTPResource has now been splitted into two diferent methods:

  String getURLPath()

  Returns the path of the URL of the resource (as a String)

  URL getURL(request)

  Retuns the full URL of the resource. With virtual hosting support, it may happen that a resource has differnt URLs according to the incomming requests, that's one of the reason for that split.

• AttributeHolderAttribute semantics has slightly changed: it is up to resources using that kind of attribute to initialize the value (if any) of that attribute, by calling their initialize method with appropriate default values.
• Resources can now refuse unloading, through the new acceptUnload method. This allows to lock a resource in memory, whatever happens. This should be use only with great care.
• The ResourceStoreHolder interface has changed in the following ways:

  notifyStoreUnload

  Has been renamed to acceptStoreUnload, and returns a boolean that indicates wether the store holder is willing to get rid of any of its references to the store. If any of that store holders return false the store will not ne unloaded.

  notifyStoreShutdown and notifyStoreStabilize

  Semantics has been slightly changed: it is nolonger up to the store holder to perform the job. The first method is the one in which the holder should get rid of all its references to the store (by nullifying them), and the second one is just a notification.

• The ContainerResource lookupStore method now throws an InvalidResourceException if the resource exists in its store but cannot be restored. In such a case, the DirectoryResource will emit an appropriate error message.
• The ServerHandler interface initialize and clone methods now provide a pointer to the ServerHandlerManager as a first parameter.
• The resource and resource store APIs have been moved outside of Jigsaw. After a year of experimentation, this code has proven usefull outside the scope of the server itself, that's why we decided to move it to a newly created package w3c.tools.store. If you have written some resources, the only change for you will be to import that new package in your class files. The precise list of classes that has moved is:
  • Attribute.java
  • AttributeHolder.java
  • AttributeHolderAttribute.java
  • AttributeRegistry.java
  • BooleanAttribute.java
  • ClassAttribute.java
  • DateAttribute.java
  • DoubleAttribute.java
  • FileAttribute.java
  • FilenameAttribute.java
  • HolderInitException.java
  • IllegalAttributeAccess.java
  • IntegerArrayAttribute.java
  • IntegerAttribute.java
  • InvalidResourceAttribute.java
  • LongAttribute.java
  • ObjectAttribute.java
  • PropertiesAttribute.java
  • Resource.java
  • ResourceLocker.java
  • ResourceShadower.java
  • ResourceStore.java
  • ResourceStoreHolder.java
  • ResourceStoreManager.java
  • SimpleResourceStore.java
  • StringArrayAttribute.java
  • StringAttribute.java
  • UnknownResourceException.java
• The ResourceStoreManager unpickleProlog method no longer returns a boolean. Instead it throws one of:

  NotAStoreException

  If the file preambule doesn't match the store cookie.

  InvalidStoreClassException

  If the class willing to load that repository doesn't match the class that saved it.

  InvalidStoreVersionException

  If the repository version doesn't match the loading class version.

Compatible changes

• HTTPResource defines a new verify method, that might be called by a resource store salvager to check the consistency of the resource.For example, file system based resources will use that method to check that the file or directory they wrap still exist, and delete themselves if not.
• DirectoryResource listing now emits HTML3.2 compliant documents, along with a link to the container (when possible)
• The realms catalog no longer uses absolute pathes, it will not however upgrade all realms catalog to not using absolute path. Relative path are relative to the server's auth directory (typically config/auth)
• The w3c.jigsaw.space property is no longer settable through the Admin properties editor. This was an oversight. The only way to set the space for a server, is through the -space commandline toggle (check the command line page for more details)

New features

• A new SalvagerResource  has been written. This resource will walk through the entire resource space, to check for:
  • Cycles in resource stores (due to Jigsaw bugs)
  • Unused resource stores (it garbage collects the stores)
  • Synchronize resources with the file system, by calling the verify method of all resources.
• A new ResourceWalker interface is available, along with a WalkerEngine. These two classes provide respectively an interface to handle the walk, and an engine that will trigger call to implementors of previous interface while walking through a resource space.

Bug fixes

Numerous bug fixes have been omitted from the list, that list only the main ones:

• The ResourceStoreManager had numerous bugs, most of them should now be fixed.
• The ICPFilter HTTP client side filter that implements the Internet Cache Protocol should now be compatible with Squid implementations
• CVS has been fixed in numerous ways; the PutList resource should now be usable.
• The basic class AuthFilter now performs authentication during lookup, rather then at ingoingFilter's time.

---

Jigsaw 1.0alpha4

A member specific release, made on January the 13th, 1997.

Incompatible changes

• Properties are no longer saved in a single file, each ServerHandler has to manage its own property file. The file is designated through the server identifier. This means that older httpd.props file should be changed by:
  • Renaming them to http-server.props (the default server identifier)
  • All properties prefix should be removed (ie all http-server prefixes)
• The AttributeHolder pickling format has changed:
  • The FilteredResource pickling method had a bug (it didn't conform to the general format)
  • Before being dumped, attribute values are prefixed by theire pickled length. This allows the unpickleInstance method to skip unknown (ie deleted) attributes.
• The DaemonProperty class is now only used as a property loader. It implements a catalog of property sets; each ServerHandler instance is responsible for managing its own ObservableProperties instance.
• The getURL method of User HTTPResource instances now return the full path of the resource within any of the server contexts (it used to return the full URL).
• The abstract Attribute class now defines a new getPickleLength abstract method (that has to be defined by sub-classes). This method is used for the new pickling format of resources, to allow the unpickle method to skip unknown attribute values.
• The ResourceStore API has changed (for ResourceStore implementers only). The getVersion method has been added, and must return the version of the class that implements the store.

  
  The initialize method has a new opaque token parameter, to be used by the store when calling back the resource store manager (eg when calling the markModified method). The token can be thought of as the identity, for the resource store manager, of the store.

• The HttpManager can now be instantiated several times within the same process. This allows for different context for the HTTP client side API. More precisely, the new method getManager(Properties props) will create a new manager if no other manager has been created with that exact property set.

Bug fixes

• The CommonLogger now initializes its buffer size properly from properties.
• Several fixes in the CacheFilter (protocol implementation errors)
• Bug fixes in the server-side Request object, wouldn't allow for non persistent connections.
• The new SocketClientFactory now properly deletes old clients if needed (old clients would otherwise tend to be priviledged wr to newer ones).

New features

• Created the w3c.jigsaw.contrib.PasswordEditor resource, that allows web site users to change their own password within a given realm.
• Created the w3c.jigsaw.contrib.CheckpointResource that will backup Jigsaw configuration every once in a while.
• Created the w3c.jigsaw.contrib.LogFilter filter, that allows for very flexible monitoring of an URL sub-space.
• Added UNIX specific command line options, to be able to run Jigsaw on port 80, as any user, under any groups. Support also provided for chroot'ing Jigsaw under UNIX, check the FAQ entry.
• The proxy now provides minimal support for ICP, through the ICPFilter.
• Sun's servlet API is now supported, servlets can be downloaded from the net ! Check the ServletWrapper and RemoteServletWrapper resources.

Compatible API Changes

• the Client getOutputStream method now returns a DataOutputStream.
• Revamped ClientPool, Client into abstract classes, etc. Check the new Client and ClientFactory APIs. This dos not affect any of the resources, but a set of properties did change in this process. All properties starting with w3c.jigsaw.ClientPool are now changed, check the SocketConnectionProp resource for more infos.
• The httpd class now has an a new errlog method, to signal error in a homogeneous way from resources (it takes a resource and a message as a paragmeter):

  
  errlog(HTTPResource resource, String msg)

• The Logger interface now define a sync method for asking the loggers to flush whatever they have back to disk.
• The Resource object defines a new store-entry attribute, to be used by the store of that resource as a closure (typically caching resource stores have an entry for each loaded resource to keep track of lockers, etc). The ResourceStore interface has been changed to reflect this: all methods that used to take a resource identifier as a parametr can now take the resource instead, and find up the entry through that new attribute.
• The DirectoryResource class functionalities has been splitted into two sub-classes:

  StoreContainer

  Defines a basic resource container, that keeps track of its children through a resource store. It doesn't know nothing about a file system

  DirectoryResource

  Now extends the StoreContainer, and knows how to serve files from a file-system.

• The ContainerResource for registering children, registerResource, now take as a parameter an HTTPResource instead of a Resource.
• The HTTPResource perform method has been splitted into three separate stages, to allow for more flexible customization of the process of performing a request:

  filterIn

  Applies all the filters on the way in, before the request gets processed. If this method returns a non-null Reply, it is assumed that some filter knew how to generate a reply on behalf of the target resource (eg a RAMCacheFilter)

  dispatch

  Dispatches the well-known HTTP methods (ie GET, POST, PUT, etc) to the appropaite Java methods (ie get, post, put...)

  filterOut

  Applies all filters on the way out. If this method returns a non-null reply, it is assumed to subsume the original reply (as obtained by calling dispatch).

---

Jigsaw 1.0alpha3

A public release, made on October 7th, 1996.

This release is mainly a bug fix release with regard to the 1.0alpha2 release.

Bug fixes

Main bug fixes are:

• The HTTP client side code has been reworked. This shouldn't affect users of that package, since it is mainly a rewritting of the internals of the HttpManager. The main problem was the managing of persistent connections, which is now much enhanced. The code was also cleaned up in that process.
• The cache garbage collector really works now ! The 1.0alpha2 cache garbage collector was just a proof of concept. The new garbage collector works by chunking the flow of data being cache through generation numbers, which allows for a much more precise garbage collections.

New features

A small set of enhancements has been made too:

• Virtual hosts capabilities have been added, this feature supports only the Host based version of that feature (which doesn't consume IP addresses). More documentation is available here.
• The ContainerResource is now an abstract class, much more suitable for sub-classing then the DirectoryResource.
• The ProxyDirectory now has a disconnected mode, which allows you to connect your laptop from the net, get any numbers of document, disconnect from the net to later browse while on a trip. Check it !
• A new MirrorDirectory  resource has been added, that allows you to mirror any web site. This resources is a nifty subclass of the newly created ForwardDirectory resource.

---

Jigsaw 1.0alpha2

A member specific release, made on September 7th, 1996.

This member release of Jigsaw, version 1.0a2 is a snapshot of what will be Jigsaw 1.0a3, the next public release. It has lots of improvements, and lots of new features that you should check out:

HTTP/1.1

The server is now fully HTTP/1.1 compliant, it will still be compatible with older, HTTP/1.0 clients.

Caching proxy

This new release includes a caching proxy module, also fully HTTP/1.1 compliant. The HTTP client side API that is used by this proxy can be used as a replacement for the default HTTP Java handler. See the FAQ for more infos.

New resources

A set of new resources and filters have been added to the core distibution:

SSIResource

The server side include resource will handle standard server side include commands. It is easily extensible in Java (make sure you check our tutorial on how to extend it). This resource is extremely powerfull and flexible and also impresively efficient, we urge you to have a look at it !

Image maps

A new image map resource has been included in the release. This adds image map support within the server in a very efficient way.

ErrorFilter

Allows you to redefine all the error messages leaving the server, by using internal redirection.

Enhancements

A lots of enhancements has been made to Jigsaw since release 1.0a1. Among which:

Performance tuning

Although not fully tuned yet, this release deal with some of the bottlenecks found in older release. Inparticular, the new client pool class allows Jigsaw to handle gracefully an increased number of simultaneous connections.

Configuration

Has been enhanced in several ways. Check the /Admin directory to see them !

CgiResource

The new support for CGI scripts is much more easy to configure and use. It also has imrpoved a lot in terms of robustness. It has been tested on both UNIX and Windows.

PICS support

The PICS module of Jigsaw has been updated to reflect the PICS 1.1 specification.

---

Jigsaw 1.0alpha1

The first member and public release, made on May, 1st 1996 and June

This was the first available Jigsaw release.