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.