If you want to start without reading too much - See instruction at the end of this document.
Following products will be required before assembling the source code:
- Java SDK 1.4 or above at http://java.sun.com
- Apache Xerces 2.7 or above at http://xerces.apache.org/xerces2-j
- Java Mail 1.4 or abovve at http://www.oracle.com/technetwork/java/javamail/index.html
- IKVM 0.26 or above at http://www.ikvm.net (only required for .Net project compilation)
For java compilation, mount the following directories and reference the xercesImpl.jar
src - java source
test - java unit test
Apache Ant also can be used for building project.
Create build.property to set location for Xerces ad IKVM
- Apache Ant 1.6 or above
For .Net compilation the .Net Framework v1.1 or above is required.
First make the jar file.
Convert the xercesImpl.jar into .Net assembly
("ikvmc -target:library xercesimpl.jar"). Some error occurs related to DOM but we are not using them.
Then convert the jar file containing the HierarchicalMap
("ikvmc -target:library -r:xercesimpl.dll dhmp.jar").
reference the two asseblies above and also IKVM.GNU.Classpath.dll
msnet - .net projects directory
dhmpms - .net equivalent for HierarchicalMap and related classes
dhmpdefaultcvt - converter classes between java and .net objects
UnitTest - .net unit test
To run the unit test or any project using .Net, IKVM.Runtime.dll will be required.
If you have made any improvements or corrected a bug, please email us at hierarchicalmap@dhmp.org
Enjoy!
Instruction:
0 - download HierarchicalMap source file and expand it. If you're reading this you've already done it ;-)
1 - download Xerces, JavaMail, Ikvm, .Net Framework and Ant (If you do not have them yet.)
2 - go back to "source" directory and update build.properties to set location for Xerces, JavaMail and Ikvm (you must copy it from build.properties.default and change whatever required to fit your environment)
3 - run ant (without any parameter. Run "ant pack-plain" if you hate bill or are using non Windows environment)
4 - voila! you get the result at "dist" directory
remark:
Ikvm and .Net are only required if you're in Windows and want to use .Net.
"/temp" directory with write permission is required to run test cases.