Declaring the use of Rogue Wave JViews services

TGO > General information > Deployment licenses > Declaring the use of Rogue Wave JViews services

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:

JViews_Maps_for_Defense_Deployment

JViews_TGO_Deployment

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:

1. 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-class>ilog.views.util.servlet.DeploymentLicenseRequired_for_JViews_Enterprise_Deployment</listener-class>

</listener>

2. 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-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.