All the products and materials by OOP-Research are developed and published based on your feed back. When you are using our products or reading our articles, you may have questions or difficulties. Whenever this is true for you, don't hesitate to contact us. Please share your opinion with us. Then, you will get the better products. (We offer 1 year FREE upgrade!) Or the new articles or examples may be published and they may shed the light on your Java development.
The more you talk, the more you get!
Based on your feed back, OOP-Research will continue to publish the new examples, sample source codes and articles for this API. You will find the links to them on our web site at the URL of:
On the upper part of this web page, there is the section titled Related Pages. And the links to the new resources will be listed in this section. So, please visit the above URL periodically.
OOP ViewGenerator API generates the HTTP response from the template XML. And this template XML can be generated from HTML (or any mark-up languages, such as HDML, WML and XHTL) by HtmlToXml conversion tool. Before you start the development with this Java API, please read about HtmlToXml conversion tool at:
While HtmlToXml conversion tool above is the easy to use Swing GUI tool, it may take much time to convert many HTML. In such a case, this command line tool for bulk conversion will be the good alternative. And it is is included in the distribution. For details, please read its README.html
In this distribution, you will find the following files and directories:
| README.html | This file. |
| LICENSE | The license agreement of this product. Please read this file before using this product. |
| html2xml |
In this directory, you will find:
|
| html2xml_command |
In this directory, you will find:
|
| apiDoc | API documentation (JavaDoc) of ViewGenerator API. |
| lib |
The binary files of ViewGenerator API are included in this directory.
They are:
|
| conf | Property files for ViewGenerator API. For details, please read the next section. |
When you extract the distribution of this Java API, you will find:
under conf sub-directory. As for the first 3 property files, please read the tutorial for HtmlToXml convertion tool.
| ViewGenerator.properties | This property file specifies the basic properties of this API. |
| view-map.xml |
This XML defines the mapping between the path information and the local path of the template XML.
The mapping must be defined per host.
The path information is the path information that comes after the servlet path, and it does not include the query string. And the path information in this XML can include the single wild card character (*) between the slashes (/). The corresponding local path of the template XML means the relative path under WEB-INF/classes. Please copy this file as view-map-0.xml. You can make several copies of this XML, and their file names should be:
|
| view-default-conf.xml |
This XML defines the mappings of the key and the value.
The mapping must be defined per host.
The values are inserted between the tag fragments of the template XML. The key specifies where to place the value. Each value can be kept in one of the 2 format, one is the String and another is the byte arrays. When the template XML is used for generating the HTTP response, the value can be written to the OutputStream.In this case, the value should be kept in the form of byte arrays. But, the template XML can also be used just to generate the String, and the value should be kept as the String in this case. Please copy this file as view-default-conf-0.xml. You can make several copies of this XML, and their file names should be:
|
Please place them into (docBase)/WEB-INF/classes for your web application context.
The docBase directory of your web applications will include the following JAR files and property files:
Be sure to give the Read permission for these files.
NOTE for oop_util_x_y.jar:
If you have the older version oop_util_x_y.jar, please replace it with the newest one. In other words, please be sure to find only the latest version of oop_util_x_y.jar under WEB-INF/lib directory.
The trial version sends your serial ID to our server over the net. If you are behind the fire-wall, this Java API may fail to connect to our server. In this case, you will get:
or similar exception. If this is the case, please feel free to contact our technical team. We will send you another trial version, which does not send your serial ID over the net.
To add the required JAR files to the new project ...
Dialog titled New Project will be shown. Please go ahead, then you will reach the section titled Java Setting Otherwise, please finish to set up the new project. You can add the JAR files later on the existing project.
For existing project ...
Dialog titled Properties for xyz (where xyz is the name of the project) will be shown. On the left navigation tree, select Java Build Path
To add the required JAR files to the new project ...
Dialog titled Project Wizard will be shown. Go ahead to the section titled Step 2 of 3
For existing project ...
Dialog titled Project properties will be shown. On the left navigation tree, select the item titled Paths
The distribution of this API is available at:
Whenever you have questions, please feel free to contact us at tech@oop-research.com. Please include your serial ID within your message.
ALL CONTENTS COPYRIGHT 2006, OOP-Research Corporation. All rights reserved.