# Fiddler
v2.0_002 Release Notes

### Description

"Fiddler" is the name of the contributed Jini(TM) technology lookup discovery service implementation from Sun Microsystems. The Jini(TM) Lookup Discovery Service Specification is available in html.

The specification for Fiddler is defined not only by the Jini(TM) Lookup Discovery Service Specification, but also by the API documentation (generated by the Javadoc(TM) tool) for `com.sun.jini.fiddler.FiddlerAdmin` and `net.jini.admin.Administrable`.

### Changes since the v2.0 release

A couple of new permissions have been added to the example policy files. You may need to add these permissions to any policy files you have generated from the manpage contained in the v2.0 release.

### Changes since the v1.2.X release

Modes of Execution
  Fiddler can now be run in three modes:
  - Transient - Fiddler does not persist its state and is not activatable
  - Nonactivatable - Fiddler does persist its state but is not activatable
  - Activatable - Fiddler persists its state and is activatable
  For details, see the `com.sun.jini.fiddler` package documentation.

Configuration
  Fiddler can now be configured using a `Configuration`. Fiddler supports configuration entries having names that are associated with the component name `com.sun.jini.fiddler`. The entries recognized by Fiddler can be used to configure behavior and aspects of the service such as:

  - The directory in which persistent state should be stored
  - Exporting the service
  - Proxy preparation
  - Discovery management
  - Lease management
  - Join state information
  - Thread allocation and management
  - Various parameters for tuning service operation

  A full list of supported configuration entries is given in this service's man page.

Proxy Interface Additions
  Proxies to Fiddler that implement the interfaces listed below now additionally implement the `ReferentUuid` interface, as well as the `RemoteMethodControl` interface if the underlying server remote reference implements `RemoteMethodControl`:

  - `LookupDiscoveryService`
  - `LookupDiscoveryRegistration`
  - `Lease`
  - `FiddlerAdmin`

Logging
  Fiddler now logs diagnostic information, using a separate `Logger` for each type of information it logs. The name of each `Logger` is a dot-separated concatenation of the implementation package name, `com.sun.jini.fiddler`, with a descriptive string. A description of each `Logger` used by this service, as well as what information is logged to which `Logger` and at what logging level, is given in this service's man page.

System Properties
  Fiddler previously supported only one system property, `com.sun.jini.fiddler.server.debug`. That system property, which provided a mechanism for enabling the generation of diagnostic information, is no longer supported by Fiddler. That mechanism has been replaced by the `Logger` mechanism described above.

Changes to `Fiddler`'s Administrative Interface
  The names of the methods defined in the `FiddlerAdmin` interface have changed. This was done to avoid confusion, and to provide consistency with the names of the configuration entries used to control operations related to persisting state. Applications that currently invoke any of the methods of the `FiddlerAdmin` interface should be changed according to the following table:

  Old Method Name | New Method Name
  --- | ---
  setLeaseDurationBound | setLeaseBound
  getLeaseDurationBound | getLeaseBound
  setSnapshotWeight | setPersistenceSnapshotWeight
  getSnapshotWeight | getPersistenceSnapshotWeight
  setLogToSnapshotThreshold | setPersistenceSnapshotThreshold
  getLogToSnapshotThreshold | getPersistenceSnapshotThreshold

Copyright 2004 Sun Microsystems, Inc. All Rights Reserved.