/
CHANGES-3.0.txt
156 lines (144 loc) · 8.01 KB
/
CHANGES-3.0.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
This file contains a detailed explanation of the changes between individual
versions of XINS, for the XINS 3.0-branch.
XINS project file:
* Attribute apisDir on root element indicates which directory contains the
APIs, default is "apis" (which is backwards compatible).
Logdoc:
* Separated out to a separate project, see http://github.com/znerd/logdoc/,
libraries are in logdoc-base.jar and logdoc-ant-tasks.jar.
Java2HTML:
* Removed support for j2h (Java2HTML).
XINS/Java Common Library:
* Library class now loads version from JAR manifest, once, at class init.
* HTTPMethod now supports HEAD method.
* Added various logXXX methods to the Utils class.
* Deprecated Utils.getJavaVersion, use SystemUtils (in Commons Lang) instead.
* Added a package 'logging' with a class LoggingThread. This class can be
derived from by thread implementation classes that perform Log4J logging.
The Log4J diagnostic context identifier is set and unset on the thread
automatically.
* Created org.xins.common.service.AbstractCallExecutor, that can be derived
from by service caller implementations to execute the actual call in a
separate thread, keeping track of duration, total time-out, etc.
This class derives from LoggingThread. The CallExecutor class within the
HTTPServiceCaller now derives from AbstractCallExecutor.
* Added interface org.xins.common.xml.ToXML with a single toXML() method.
* Added improved getLocalHost method to class IPAddressUtils.
* HostnameTask now uses new getLocalHost method in class IPAddressUtils.
As a side-effect, some of the logging now goes to Log4J instead of Ant.
* AbstractPropertyReader now implements ToXML.
* Added various utility methods to class PropertyReaderUtils.
* Added interface org.xins.common.collections.ToPropertyReader with a
single toPropertyReader() method.
* Added Use enum with values OPTIONAL and REQUIRED.
* Type "_dir": printing absolute path when directory cannot be found/read.
* Removed thread safety checking from ElementSerializer class.
* Added getOptionalChildElement methods to the Element class.
* Added class PropertyException to 'collections' package.
* InvalidPropertyValueException now extends from PropertyException.
* InvalidPropertyValueException adds new constructors.
* MissingRequiredPropertyException now extends from PropertyException.
* Added copyUnmodifiable(PropertyReader) to PropertyReaderUtils class.
* Implemented toString() method in AbstractPropertyReader class.
* Added methods to TextUtils: hash, hashToString, nullIfEmpty, fuzzyEquals.
* PropertyReaderUtils.parsePropertyReader supports XML.
* Added names() method to PropertyReader interface that allows the use of
the Java 5 foreach-operator. It returns a Collection<String>.
* Deprecated PropertyReader.getNames() in favour of the names() method.
* Added ElementUtils class in org.xins.common.xml.
* Removed FastStringBuffer and FastStringWriter classes, marked deprecated
since XINS 2.0.
* Removed PropertyReaderUtils method that accepts a FastStringBuffer
argument. The method was deprecated since XINS 2.0:
serialize(PropertyReader, FastStringBuffer, String)
* Removed all HexConverter.toHexString methods that accept a
FastStringBuffer argument. They were deprecated since XINS 2.0.
* Added HexConverter.parseHexByte(String,int).
* HexConverter.toHexString(byte[]) now allows 0-length byte array input.
* Fixed example in class description (Javadoc) of DateConverter.
* Added TextUtils.toUTF8(String).
* Added TextUtils.getEnumItem(Class,String,boolean).
* Added PropertyReaderUtils.createPropertyReader(String,String).
* Logdoc: Enabled parameter value filtering for messages 1100-1110.
* Improved exception handling in ElementParser.parse(File).
* CallConfig class now abstract and has a protected constructor.
* Replaced Element.addChild(Element) with add(Element).
* Replaced Element.addText(String) with add(String).
* Deprecated XINSHttpSession.getAttributeNames, which returns an Enumeration,
in favour of the new getAttributes() method that returns a Map.
* Deprecated ChainedMap, in favour of LinkedHashMap in J2SE 1.4.
* ChainedMap supports generics.
* Changed SAXParserProvider to not only handle an Exception, but Throwable.
* Changed some code to use Java SE regex framework instead of Jakarta ORO
(TODO, work in progress).
* FunctionSpec/APISpec classes simplified, using generics.
* Changed FunctionSpec/APISpec methods to return unmodifiable collections/maps.
* Fixed NPE in FormattedParameters.
* Fixed issue in PatternType.
* Added PropertyReaderResource.java to spring package.
XINS/Java Client Framework:
* Library class now loads version from JAR manifest, once, at class init.
* Enabled parameter value filtering for messages 2100-2115.
* Client-side transaction logging in XINSServiceCaller, messages 2300/2301.
XINS/Java Server Framework:
* Library class now loads version from JAR manifest, once, at class init.
* Logged the time taken by the initialization.
* Minor improvements to Javadoc documentation for generated getters.
* Calling convention provides original FunctionRequest to convertResultImpl.
* Changed signature of SOAPCallingConvention.setDataElementAttribute.
* Enabled parameter value filtering for messages 3520-3523, 3540.
* Changed some code to use Java SE regex framework instead of Jakarta ORO
(TODO, work in progress).
* Supporting "targetFunction" parameter on _GetStatistics function.
* _GetStatistics now returns transaction IDs for calls.
* Not initializing logging subsystem if system property
"org.xins.server.logging.init" is set to "false".
* Default runtime config file reload interval is now 5 instead of 60 seconds.
* Not setting context IDs if property "org.xins.server.contextID.push" is set
to false (system, bootstrap or runtime property).
* Added (package-private) Engine.getConfigManager().
* Added MultipartServletRequestWrapper (requires commons-fileupload).
Libraries:
* Upgraded to Juxy 0.8.
* Apache Commons HttpClient 2.x is no longer supported, 3.x is required.
* Added Apache Commons IO 1.4.
* Upgraded Cobertura from version 1.8 to 1.9.1.
* Upgraded Jaxen (used by PMD) from version 1.1-beta7 to 1.1.1.
* Upgraded ASM (used by PMD and Cobertura) to version 3.1 (now also
includes asm-tree.jar file, needed by Cobertura).
* Upgraded JUnit to version 4.5.
* Upgraded to Saxon HE (Home Edition) 9.2.0.2. Removed lib/saxon9-dom.jar,
that is now integrated in the regular saxon9he.jar file.
* Removed Xerces library (xercesImpl.jar, xml-apis.jar), relying on the
Xerces distribution as part of Java SE platform.
* Added Spring 3.0.5 JAR files to the lib directory.
* Added commons-lang.jar to the lib directory.
* Added commons-fileupload.jar to lib directory.
* Added ant.jar to lib directory.
Serialization:
* Added a serialVersionUID field to some classes, this may break compatibility
with older XINS versions.
Validation of definitions:
* In 'index-specdocs' target: Validating project file using XSD.
Generation of specdocs:
* Visited links now also show underlined when hovered over.
* Using term 'error code' instead of 'result code'.
* Improved messages related to Logdoc definitions in generated file for API.
* Minor changes to text in generated index.html file.
* Showing ellipsis instead of API_PATH in function example requests.
* Added classes and IDs on elements in index.html, to easen custom styling.
* Type no longer assumes a pattern applies to the whole line (hence no longer
adding line start and end markers to the regular expression).
Generation of Java code:
* Changed default_resultcodes_to_java.xslt to put a warning ("do not edit")
in the top of the generated Java source file.
Other:
* Marked all XSLT stylesheets as XSLT version 2.0 (instead of 1.0).
* Added DTDs for XINS 3.0.
* Simplified 'xins' shell script and 'xins.bat' batch file.
* Added support for XINS_ANT_VERBOSE to xins shell script.
* XINS own build(-dev).xml now passes Xlint compilerarg to javac.
* Allowing JMX port to be specified, e.g. "xins run-XXX -Djmx.port=2090"
* Shell script now allows space(s) in the XINS home directory.
* Generated documentation now goes to build/ instead of docs/.
* Added support for the _decimal type.