Table of Contents
Just a second...

What's in a DAR file?

A DAR file contains the JAR file that contains the publisher Java™ files, one or more XML configuration files, a manifest file, and any other files required by your publisher.

Figure 1. Example folder structure inside a DAR file The root folder name is the name of the publisher. It contains the following folders: META-INF, etc, ext, html. The META-INF folder contains a manifest file, MANIFEST.MF. The etc folder contains the following configuration files: Aliases.xml, Publishers.xml, SubscriptionValidationPolicy.xml. The ext folder contains the JAR file, MyPublisher.jar. The html folder contains the index.html file.

The root folder name is the name of the publisher.

The MANIFEST.MF file contains an attribute, Diffusion-Version, which specifies the minimum version number of Diffusion™ on which this publisher runs. This prevents deployment of publishers to Diffusion instances which might not support features of the publisher or have different API signatures.

Manifest-Version: 1.0
Diffusion-Version: 5.9.4

The etc directory contains files which are normally found in a Diffusion installation's etc directory, but contain only information relating to the publisher being deployed. Files that affect the operation of Diffusion and have no relationship to the publisher are not loaded. Valid configuration files are:

etc/Aliases.xml
Include this file if there are associated HTML files.
etc/Publishers.xml
You must include this file.
etc/SubscriptionValidationPolicy.xml
Include this file if it is referenced from the etc/Publishers.xml file.

The Publishers.xml file has the same structure and the one in a Diffusion installation's etc directory. For more information, see Publishers.xml.

For example:
<publishers>
        <publisher name="MyPublisher">
                <class>com.pushtechnology.diffusion.test.publisher.MyPublisher</class>
                <start>true</start>
                <enabled>true</enabled>
        </publisher>
</publishers>

Put all Java code required by your publisher in the ext folder. All files in this directory are placed on the classpath for the publisher. You can include any required third-party JAR files or resources in this folder.