oracle.jdeveloper.audit.service
Class Profile

java.lang.Object
  oracle.jdeveloper.audit.service.Profile

Direct Known Subclasses:

DefaultProfile

public abstract class Profile
extends java.lang.Object

A set of analyzers with category, rule, and metric bean properties configured to specific values. A profile is essentially an analyzer factory which instantiates exactly one analyzer for each analyzer class registered with Audit and configures the properties of its beans.

Profiles are typically created with the URL of a profile file by the profile repository. The profile name and the bean property values are lazily loaded from the profile file. An auditor causes the profile to instantiate the analyzers and configure the bean properties at the start of an audit, and to release the analyzer and bean instances to the garbage collector at the end of an audit. If rerun, the auditor will cause the same profile to instantiate and configure new instances. A profile can be created in one of three ways:

1. With a URL of a profile file. The profile name will be obtained from the file and the analyzer classes will be all those registered with Audit. The bean property configuration will be loaded and applied when the analyzer instances are created. The instances will be created on demand.
2. With an existing profile and a new name and URL. The bean property configuration will be copied from the existing profile; if the existing profile was modified, the bean property configuration will revert to its saved state (effectively, the instances of the existing profile are given to the new profile).
3. With one or more analyzer instances: The set of analyzer classes and instances will be those provided to the constructor. The bean property configuration will be deduced from the instances on demand.

Creation with a URL is used by the profile repository to create the profiles used by the profile dialog, and can also be used by an Audit extension to create a default profile from a profile file installed with the extension. Creation with an existing profile is used by the profile dialog Save As action. Creation with analyzer instances is used by clients that invoke Audit programmatically with specific analyzers and are only interested in a limited set of analyzers.

See Also:

Analyzer

Nested Class Summary

static class	Profile.Instances
static class	Profile.Setter

Constructor Summary

Profile()

Method Summary

abstract void	addChangeListener(javax.swing.event.ChangeListener listener)
abstract Profile.Instances	createInstances() Creates a set of analyzer and bean instances from this profile.
abstract ProfileTransaction	createTransaction() Creates a transaction for this profile.
abstract java.util.Collection<java.lang.Class<? extends Analyzer>>	getAnalyzerClasses() Gets the analyzer classes from this profile.
abstract java.lang.String	getKey() Gets the creation key of this profile, or null if this is a user-created profile.
abstract java.lang.String	getName() Gets the name of this profile.
abstract java.net.URL	getURL() Gets the URL where the contents of this profile are saved, or null if new.
abstract boolean	isDefault() Gets whether this profile is a default profile.
abstract void	removeChangeListener(javax.swing.event.ChangeListener listener)
abstract void	save(java.net.URL url) Saves this profile.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Profile

public Profile()

Method Detail

addChangeListener

public abstract void addChangeListener(javax.swing.event.ChangeListener listener)

removeChangeListener

public abstract void removeChangeListener(javax.swing.event.ChangeListener listener)

getName

public abstract java.lang.String getName()

Gets the name of this profile.

isDefault

public abstract boolean isDefault()

Gets whether this profile is a default profile.

getKey

public abstract java.lang.String getKey()

Gets the creation key of this profile, or null if this is a user-created profile.

getURL

public abstract java.net.URL getURL()

Gets the URL where the contents of this profile are saved, or null if new.

getAnalyzerClasses

public abstract java.util.Collection<java.lang.Class<? extends Analyzer>> getAnalyzerClasses()

Gets the analyzer classes from this profile.

createInstances

public abstract Profile.Instances createInstances()

Creates a set of analyzer and bean instances from this profile.

createTransaction

public abstract ProfileTransaction createTransaction()

Creates a transaction for this profile.

save

public abstract void save(java.net.URL url)
                   throws java.io.IOException

Saves this profile.

Throws:

java.lang.IllegalStateException - if the URL is null.

java.io.IOException