Before you can use a Rogue Wave® JViews feature, this feature
must be declared through a call to the method IlvProductUtil.DeploymentLicenseRequired with an argument that indicates the set of features that you intend
to use and for which you will therefore need a deployment license
when you deploy the application.
The available feature sets are declared in the IlvProductUtil
class:
JViews_Enterprise_Deployment includes features for diagrams (including graph layout), Gantt charts,
charts, and maps.
JViews_Charts_Deployment denotes the features for charts (excluding Gantt charts).
JViews_Diagrammer_Deployment denotes the features for diagrams.
JViews_Gantt_Deployment includes the features for Gantt charts and charts.
JViews_Maps_Deployment includes the features for maps and diagrams, excluding graph layout,
but including label layout.
The other feature sets declared in IlvProductUtil correspond to products:
The following examples show how to declare the feature
sets for deployment. For feature set declarations in Java applications
that are not Web applications, use the IlvProductUtil.DeploymentLicenseRequired method and supply the correct deployment parameter to the IlvProductUtil argument. For Web applications, use
a listener element (<listener>
) in the web.xml file of the Web application.
Examples of declaring feature sets for deployment:
If you intend to use all features of Rogue Wave JViews Enterprise:
In a non-Web application, insert this
call into your application code:
IlvProductUtil.DeploymentLicenseRequired(
IlvProductUtil.JViews_Enterprise_Deployment);
In a Web application, insert this element
in the application’s web.xml file:
<listener>
<listener-class>ilog.views.util.servlet.DeploymentLicenseRequired_for_JViews_Enterprise_Deployment</listener-class>
</listener>
If you intend to use only diagrams and
maps:
In a non-Web application, insert these
calls in your application code:
IlvProductUtil.DeploymentLicenseRequired(
IlvProductUtil.JViews_Diagrammer_Deployment);
IlvProductUtil.DeploymentLicenseRequired(
IlvProductUtil.JViews_Maps_Deployment);
In a Web application, insert this element
in the application’s web.xml file:
<listener>
<listener-class>ilog.views.util.servlet.DeploymentLicenseRequired_for_JViews_Diagrammer_Deployment</listener-class>
<listener-class>ilog.views.util.servlet.DeploymentLicenseRequired_for_JViews_Maps_Deployment</listener-class>
</listener>
If at run time you use a feature set that you have not
declared, an exception of type IlvFeatureUseNotAcknowledgedException is raised. The message of this exception contains an indication
of which feature sets the requested feature belongs to.
Placing calls to
IlvProductUtil.DeploymentLicenseRequired, or adding listeners in Web applications, makes it possible for
you to use the selected Rogue Wave JViews feature sets, but it does not give you the legal
rights to deploy an application that uses these features. For these
legal rights, you need to acquire a
Deployment license for the feature sets. Refer to the license agreement,
<installdir>
/license/LicenseAgreement.txt, for details.