IBM®
Skip to main content
    United States change      Terms of use
 
 
Select a scope:    
     Home      Products      Services & industry solutions      Support & downloads      My account     
alphaWorks  >  XML  >  

Xeena

Xeena is a generic Java application from the IBM Haifa Research Laboratory for editing valid XML documents derived from any valid DTD.


Date Posted: March 8, 1999
Overview Requirements DownloadFAQsForum Reviews

1. How much of the XML specification does Xeena support?
2. To what extent does Xeena validate the files it creates and edits?
3. How do I configure Xeena for my DTD?
4. How do I configure Xeena to enable importation of documents from different formats?
5. How do I configure Xeena to enable exportation of documents into different formats?
6. How do I configure Xeena to enable invocation of a tool on a document?
7. How do I configure Xeena to use a different UI Look & Feel?
8. How do I configure Xeena to use an HTTP proxy?


1. How much of the XML specification does Xeena support?

Xeena supports the XML specification specified at http://www.w3.org/TR/1998/REC-xml-19980210 except for the following:
  • DTD inside XML files
  • Entity references (note that character references are allowed in attribute values and generated automatically by the editor).
Back to top Back to top

2. To what extent does Xeena validate the files it creates and edits?

Xeena ensures validity of the structure of each node in the tree (for example, it will not let the user insert an element in a place that is not allowed by the DTD). Xeena also checks validity of the data associated with each node (such as attributes values for elements, target values for processing instructions).

Invalid nodes are underlined in red immediately after opening a file and are checked constantly during editing. Selecting the invalid node and activating Validate from the tool bar or menu prints the error messages associated with that node in the message area.

Back to top Back to top

3. How do I configure Xeena for my DTD?

Please see the configuration instructions in the help file.
Back to top Back to top

4. How do I configure Xeena to enable importation of documents from different formats?

Xeena can be configured to import non-XML files into XML documents by invoking Java code (that you supply) to implement the transformation. To do this, follow these steps:

  1. Write a Java class that implements the XMLImporter interface. Writing this class consists of three main steps:
    1. Implement the getIcon, getName, and getToolTip methods for returning descriptions of your importer, which will be used by the Xeena environment.
    2. Implement the init methods to initialize your importer (using information from the XMLEditorContext and/or the data string you may have specified in the configuration file).
    3. Implement the importDocument method to do the actual work of letting the user select an import source and import the data into the document. For a detailed sample, please examine the BMLImporter.java sample supplied in the src directory.

  2. Hook the class you wrote into the Xeena profile for your DTD as follows: When configuring Xeena for your DTD, insert a new importer element (as a child of the existing importers element), specify its name, and specify the full name of the class you wrote as the value of the class attribute.
Back to top Back to top

5. How do I configure Xeena to enable exportation of documents into different formats?

Xeena can be configured to export XML documents into non-XML files by invoking Java code (that you supply) to implement the transformation. To do this, follow these steps:

  1. Write a Java class that implements the XMLExporter interface. Writing this class consists of three main steps:
    1. Implement the getIcon, getName, and getToolTip methods to return descriptions of your exporter, which will be used by the Xeena environment.
    2. Implement the init methods to initialize your exporter (using information from the XMLEditorContext and/or the data string you may have specified in the configuration file.
    3. Implement the exportDocument method to do the actual work of letting the user select an export target and export the data from the document. For a detailed sample, please examine the BMLExporter.java sample supplied in the src directory.

  2. Hook the class you wrote into the Xeena profile for your DTD as follows: When configuring Xeena for your DTD, insert a new exporter element (as a child of the existing exporters element), specify its name, and specify the full name of the class you wrote as the value of the class attribute.
Back to top Back to top

6. How do I configure Xeena to enable invocation of a tool on a document?

Xeena can be configured to apply a tool to XML documents by invoking Java code that you supply. To do this, follow these steps:

  1. Write a Java class that implements the ToolHandler interface. Writing this class consists of four main steps:
    1. Implement the getIcon, getName, and getToolTip methods to return descriptions of your tool, which will be used by the Xeena environment.
    2. Implement the init methods to initialize your tool (using information from the XMLEditorContext and/or the data string you may have specified in the configuration file.
    3. Implement the canHandle to give an indication whether the selected documented can be handled by the tool.
    4. Implement the handle method to do the actual work of invoking the tool on the selected document. For a detailed sample, please examine the BMLPlayer.java sample supplied in the src directory.
    5. Hook the class you wrote into the Xeena profile for your DTD as follows: When configuring Xeena for your DTD, insert a new tool element (as a child of the existing tools element), specify its name, and specify the full name of the class you wrote as the value of the class attribute.
Back to top Back to top

7. How do I configure Xeena to use a different UI Look & Feel?

Edit the xeena.bat file (Windows) or the xeena.sh (Unix) file in the root directory of your Xeena installation, and change the name of the Look and Feel class (look for the string Dswing.defaultlaf=com.sun.java.swing.plaf....).

Alternatives that you can use:

    com.sun.java.swing.plaf.windows.WindowsLookAndFeel
    com.sun.java.swing.plaf.mac.MacLookAndFeel
    com.sun.java.swing.plaf.motif.MotifLookAndFeel

If you remove the option altogether, the default Look and Feel will be used.

Back to top Back to top

8. How do I configure Xeena to use an HTTP proxy?

If you intend to use Xeena to access DTDs or XML files that reside on external (outside your firewall) servers, you may need to tell Xeena which proxy server to use. This can be done via the InstallShield wizard (Windows only), or thereafter by editing the xeena.bat file (Windows) or the xeena.sh file (Unix) and setting the PROXY_SETTINGS environment variable (by default set to -DproxySet=false) to

    -DproxySet=true -DproxyHost=proxy.server.name -DproxyPort=port

where proxy.server.name is the name of your proxy server, and where port is the port number.

Back to top Back to top
Download now Download now

Related technologies

For platform(s):
Windows NT, Windows 95, Windows 98, UNIX, Windows 2000


Related resources

Tutorial: Introduction to XML

developerWorks XML zone

XML tutorials

Press Articles

 

    About IBM Privacy Contact