diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..e327e2b --- /dev/null +++ b/.gitignore @@ -0,0 +1 @@ +/wise-distribution-2.0.3.Final.zip diff --git a/LICENSE-2.0.txt b/LICENSE-2.0.txt new file mode 100644 index 0000000..d645695 --- /dev/null +++ b/LICENSE-2.0.txt @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/dead.package b/dead.package deleted file mode 100644 index 1430e47..0000000 --- a/dead.package +++ /dev/null @@ -1,3 +0,0 @@ -2016-12-11: Retired orphaned package, because it was orphaned for -more than six weeks. - diff --git a/sources b/sources new file mode 100644 index 0000000..0ce1615 --- /dev/null +++ b/sources @@ -0,0 +1 @@ +4d0d922d8b9c2c6cc026d64ddf6b9217 wise-distribution-2.0.3.Final.zip diff --git a/wise-CXFConsumerImpl.patch b/wise-CXFConsumerImpl.patch new file mode 100644 index 0000000..696cdb7 --- /dev/null +++ b/wise-CXFConsumerImpl.patch @@ -0,0 +1,16 @@ +--- core-cxf/src/main/java/org/jboss/wise/core/client/consumer/WiseCXFConsumerImpl.java.orig 2013-08-06 21:15:25.507801422 +0100 ++++ core-cxf/src/main/java/org/jboss/wise/core/client/consumer/WiseCXFConsumerImpl.java 2013-08-06 21:18:17.638705935 +0100 +@@ -55,6 +55,13 @@ + private boolean additionalHeaders = false; + private String target; + private boolean nocompile = false; ++ private File clientJar = null; ++ ++ @Override ++ public void setClientJar(File clientJar) ++ { ++ this.clientJar = clientJar; ++ } + + @Override + public void setBindingFiles(List bindingFiles) diff --git a/wise-javadoc.patch b/wise-javadoc.patch new file mode 100644 index 0000000..861db9b --- /dev/null +++ b/wise-javadoc.patch @@ -0,0 +1,861 @@ +--- src/core/src/main/java/org/jboss/wise/tree/Element.java.orig 2013-07-05 16:49:56.000000000 +0100 ++++ src/core/src/main/java/org/jboss/wise/tree/Element.java 2015-08-16 18:47:48.062419131 +0100 +@@ -71,6 +71,7 @@ + /** + * Every WiseTreeElement must be cloneable; this is required to handle + * element's add and removal into/from arrays and collections. ++ * @return Something that's of type element + */ + public Element clone(); + +--- src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/Connection.java.orig 2015-08-16 19:17:35.071143090 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/Connection.java 2015-08-16 19:18:16.105618837 +0100 +@@ -56,9 +56,9 @@ + /** + * Open an inputStream from the given URL. + * +- * @param url ++ * @param url The URL + * @return the inputStream of this url +- * @throws IOException ++ * @throws IOException An IOException + * + */ + public InputStream open(URL url) throws IOException { +--- src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/JBossEntityResolver.java.orig 2013-07-05 16:50:14.000000000 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/JBossEntityResolver.java 2015-08-16 19:21:40.415981306 +0100 +@@ -44,7 +44,7 @@ + * + * Local entity resolver to handle standard J2EE DTDs and Schemas as well as + * JBoss specific DTDs. +- *

++ * + * Function boolean isEntityResolved() is here to avoid validation errors in + * descriptors that do not have a DOCTYPE declaration. + * +@@ -207,7 +207,7 @@ + /** + * Obtain a read-only view of the current entity map. + * +- * @return Map of the publicID/systemID to dtd/schema file ++ * @return Map of the publicID/systemID to dtd/schema file + * name + */ + public static Map getEntityMap() { +@@ -347,7 +347,7 @@ + * Returns the boolean value to inform id DTD was found in the XML file or + * not + * +- * @todo this is not thread safe and should be removed? ++ * TODO: this is not thread safe and should be removed? + * + * @return boolean - true if DTD was found in XML + */ +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/EndpointMethodCaller.java.orig 2015-08-16 19:26:09.627078679 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/EndpointMethodCaller.java 2015-08-16 19:27:03.175694775 +0100 +@@ -45,9 +45,9 @@ + private final Object[] args; + + /** +- * @param epInstance +- * @param methodPointer +- * @param args ++ * @param epInstance A WSEndpoint ++ * @param methodPointer A Method ++ * @param args An Object array + */ + public EndpointMethodCaller( WSEndpoint epInstance, + Method methodPointer, +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/InvocationResultImpl.java.orig 2015-08-16 19:29:50.172616135 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/InvocationResultImpl.java 2015-08-16 19:30:44.617242540 +0100 +@@ -46,9 +46,10 @@ + private final Map originalObjects; + + /** +- * @param name +- * @param value +- * @param results ++ * @param name String ++ * @param resultType Type ++ * @param value Object ++ * @param results Map + */ + public InvocationResultImpl(String name, Type resultType, Object value, Map results) { + +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WebParameterImpl.java.orig 2015-08-16 19:31:46.277951971 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WebParameterImpl.java 2015-08-16 19:32:19.552334803 +0100 +@@ -46,10 +46,10 @@ + private final Enum mode; + + /** +- * @param type +- * @param name +- * @param position +- * @param mode ++ * @param type Type ++ * @param name String ++ * @param position int ++ * @param mode EnumMode + */ + public WebParameterImpl( Type type, + String name, +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSDynamicClientImpl.java.orig 2015-08-16 19:34:17.049686655 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSDynamicClientImpl.java 2015-08-16 19:35:00.601187729 +0100 +@@ -57,11 +57,10 @@ + import org.milyn.Smooks; + + /** +- * This is the Wise core, i.e. the JAX-WS client that handles wsdl retrieval & ++ * This is the Wise core, i.e. the JAX-WS client that handles wsdl retrieval + * parsing, invocations, etc. + * + * @author Stefano Maestri, stefano.maestri@javalinux.it +- * @since + */ + @ThreadSafe + public class WSDynamicClientImpl implements WSDynamicClient { +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSEndpointImpl.java.orig 2015-08-16 19:35:56.767833949 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSEndpointImpl.java 2015-08-16 19:36:47.697419912 +0100 +@@ -127,7 +127,7 @@ + /** + * Set username used for Basic HTTP auth in calling ws + * +- * @param username ++ * @param username String + */ + public synchronized void setUsername(String username) { + this.userName = username; +@@ -141,7 +141,7 @@ + /** + * Set password used for Basic HTTP auth in calling ws + * +- * @param password ++ * @param password String + */ + public synchronized void setPassword(String password) { + this.password = password; +@@ -160,7 +160,7 @@ + * method called + * + * @see #getWSMethods() +- * @param handler ++ * @param handler Handler + */ + public void addHandler(Handler handler) { + handlers.add(handler); +--- src/core/src/main/java/org/jboss/wise/core/client/WSEndpoint.java.orig 2015-08-16 19:37:33.303944632 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/WSEndpoint.java 2015-08-16 19:38:16.673438308 +0100 +@@ -49,7 +49,7 @@ + /** + * Set username for endpoint authentication + * +- * @param username ++ * @param username String + */ + @GuardedBy("this") + public void setUsername(String username); +@@ -57,7 +57,7 @@ + /** + * Set password for endpoint authentication + * +- * @param password ++ * @param password String + */ + @GuardedBy("this") + public void setPassword(String password); +@@ -77,7 +77,7 @@ + * method called + * + * @see #getWSMethods() +- * @param handler ++ * @param handler Handler + */ + @GuardedBy("this") + public void addHandler(Handler handler); +@@ -140,7 +140,7 @@ + * it give the opportunity to change target url of the endpoint defined in + * the wsdl + * +- * @param targetUrl ++ * @param targetUrl String + */ + @GuardedBy("this") + public void setTargetUrl(String targetUrl); +--- src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/WiseEntityResolver.java.orig 2015-08-16 19:23:41.308372218 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/wsdlResolver/WiseEntityResolver.java 2015-08-16 19:40:21.041847385 +0100 +@@ -67,8 +67,8 @@ + * Use a ResourceURL to access the resource. This method should be protected + * in the super class. + * +- * @param id +- * @param trace ++ * @param id String ++ * @param trace Trace + * @return an InputSource + */ + protected InputSource resolveSystemIDAsURL(String id, boolean trace) { +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSMethodImpl.java.orig 2015-08-16 19:42:02.717999363 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSMethodImpl.java 2015-08-16 19:42:43.030456098 +0100 +@@ -124,16 +124,16 @@ + /** + * Invokes this method with the provided arguments applying provided mapper + * +- * @param args ++ * @param args Object + * @param mapper + * if null no mappings are applied method will be invoked using + * args directly. in this case the keys of the map gotta be the + * parameters names as defined in wsdl/wsconsume generated + * classes + * @return {@link InvocationResultImpl} +- * @throws InvocationException +- * @throws IllegalArgumentException +- * @throws MappingException ++ * @throws InvocationException Exception ++ * @throws IllegalArgumentException Exception ++ * @throws MappingException Exception + */ + @SuppressWarnings("unchecked") + public InvocationResultImpl invoke(Object args, WiseMapper mapper) throws InvocationException, IllegalArgumentException, MappingException { +--- src/core/src/main/java/org/jboss/wise/core/client/WSMethod.java.orig 2015-08-16 19:43:26.298946323 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/WSMethod.java 2015-08-16 19:45:56.910652734 +0100 +@@ -57,9 +57,9 @@ + * @return return an {@link InvocationResult} object populated with returned + * values (implementation will process both directed returned values + * and OUT parameters as defined in wsdl) +- * @throws InvocationException +- * @throws IllegalArgumentException +- * @throws MappingException ++ * @throws InvocationException Exception ++ * @throws IllegalArgumentException Exception ++ * @throws MappingException Exception + */ + public InvocationResult invoke(Object args, WiseMapper mapper) throws InvocationException, IllegalArgumentException, MappingException; + +@@ -67,23 +67,23 @@ + * Invokes this method with the provided arguments + * + * @param args +- * the arguments to call operation. args must be a Map. This Map have to contain entries for all needed ++ * the arguments to call operation. args must be a Map. ++ * This Map have to contain entries for all needed + * parameters, keys have to reflect operation parameter name as + * defined in wsdl. Keys which names are not defined in wsdls + * will be simply ignored. Implementation will take care values + * nullability will reflect "nillable" properties defined in + * wsdl. order isn't important since WSMethod implementation will + * take care of reorder parameters in right position to make +- * operation call. If it isn't a Map or keys ++ * operation call. If it isn't a Map or keys + * don't contain all parameters name an + * {@link IllegalArgumentException} is thrown. + * @return return an {@link InvocationResult} object populated with returned + * values (implementation will process both directed returned values + * and OUT parameters as defined in wsdl) +- * @throws InvocationException +- * @throws IllegalArgumentException +- * @throws MappingException ++ * @throws InvocationException Exception ++ * @throws IllegalArgumentException Exception ++ * @throws MappingException Exception + */ + public InvocationResult invoke(Object args) throws InvocationException, IllegalArgumentException, MappingException; + +@@ -91,9 +91,9 @@ + * Generates and writes a preview of the request message for invoking this + * method with the provided arguments. + * +- * @param args +- * @param os +- * @throws InvocationException ++ * @param args Map ++ * @param os OutputStream ++ * @throws InvocationException Exception + */ + public void writeRequestPreview(Map args, OutputStream os) throws InvocationException; + +@@ -101,7 +101,7 @@ + * Gets the map of {@link WebParameter} for the webserice method represented + * by instance of this type + * +- * @return a Map representing valid webparameters where keys ++ * @return a Map representing valid webparameters where keys + * contain symbolic names as defined by wsdl. It may be null in case + * of selected operation haven't parameter. + */ +--- src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSServiceImpl.java.orig 2015-08-16 19:47:01.049379417 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/impl/reflection/WSServiceImpl.java 2015-08-16 19:49:23.174989681 +0100 +@@ -52,11 +52,12 @@ + protected final int maxThreadPoolSize; + + /** +- * @param serviceClass +- * @param classLoader +- * @param service +- * @param userName +- * @param password ++ * @param serviceClass Class ++ * @param classLoader URLClassLoader ++ * @param service Object ++ * @param userName String ++ * @param password String ++ * @param excludedPorts Set + * @param maxThreadPoolSize the max pool size for method execution of service attached endpoint. + */ + public WSServiceImpl( Class serviceClass, +@@ -160,9 +161,9 @@ + private final Method buildMethod; + + /** +- * @param serviceClass +- * @param serviceObject +- * @param buildMethod ++ * @param serviceClass Class ++ * @param serviceObject Object ++ * @param buildMethod Method + */ + public WSEndPointbuilder( Class serviceClass, + Object serviceObject, +--- src/core/src/main/java/org/jboss/wise/core/client/builder/WSDynamicClientBuilder.java.orig 2015-08-16 19:50:15.601583666 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/builder/WSDynamicClientBuilder.java 2015-08-16 19:53:43.792942446 +0100 +@@ -45,16 +45,16 @@ + * Build the {@link WSDynamicClient} with all parameters set on this class + * + * @return {@link WSDynamicClient} +- * @throws IllegalStateException +- * @throws ConnectException +- * @throws WiseRuntimeException ++ * @throws IllegalStateException Exception ++ * @throws ConnectException Exception ++ * @throws WiseRuntimeException Exception + */ + public WSDynamicClient build() throws IllegalStateException, ConnectException, WiseRuntimeException; + + /** + * Set the wsdlURL to generate WS client + * +- * @param wsdlURL ++ * @param wsdlURL String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder wsdlURL(String wsdlURL); +@@ -63,7 +63,7 @@ + * set the userName used in Basic Auth both for downloading wsdl and calling + * service + * +- * @param userName ++ * @param userName String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder userName(String userName); +@@ -72,7 +72,7 @@ + * set the password used in Basic Auth both for downloading wsdl and calling + * service + * +- * @param password ++ * @param password String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder password(String password); +@@ -83,7 +83,7 @@ + * {@link WSDynamicClient} and take care of all cleanup when + * WSDynamicClient.close() is called + * +- * @param tmpDir ++ * @param tmpDir String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder tmpDir(String tmpDir); +@@ -92,7 +92,7 @@ + * force the package name used for generated client classes. If it is't set + * wsconsume rules will e used: namespaces and/or bindingfiles + * +- * @param targetPackage ++ * @param targetPackage String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder targetPackage(String targetPackage); +@@ -100,7 +100,7 @@ + /** + * set the list of JAXB bindings files used by wsconsume + * +- * @param bindings ++ * @param bindings List of Files + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder bindingFiles(List bindings); +@@ -108,7 +108,7 @@ + /** + * set the catelog file + * +- * @param catelog ++ * @param catelog File + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder catalogFile(File catelog); +@@ -118,7 +118,7 @@ + * information about this file refer to our samples and/or to JBossWS + * documentation + * +- * @param url ++ * @param url String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder securityConfigUrl(String url); +@@ -128,7 +128,7 @@ + * information about this file refer to our samples and/or to JBossWS + * documentation + * +- * @param name ++ * @param name String + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder securityConfigName(String name); +@@ -137,7 +137,7 @@ + * if it it set to true source code generated for client classes will be + * kept in {@link #tmpDir(String)} + * +- * @param bool ++ * @param bool boolean + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder keepSource(boolean bool); +@@ -147,7 +147,7 @@ + * will be verbose and its messages will be put on + * {@link #messageStream(PrintStream)} + * +- * @param bool ++ * @param bool boolean + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder verbose(boolean bool); +@@ -155,7 +155,7 @@ + /** + * if it set to true non-SOAP wsdl ports will be excluded + * +- * @param bool ++ * @param exclude boolean + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder excludeNonSOAPPorts(boolean exclude); +@@ -164,7 +164,7 @@ + * Sets the PrintStream to use for status feedback. The simplest example + * would be to use System.out. + * +- * @param messageStream ++ * @param messageStream PrintStream + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder messageStream(PrintStream messageStream); +@@ -174,7 +174,7 @@ + * {@link WSMethod} on the build {@link WSDynamicClient}. default value is + * 100. + * +- * @param maxThreadPoolSize ++ * @param maxThreadPoolSize int + * @return {@link WSDynamicClient} + */ + public WSDynamicClientBuilder maxThreadPoolSize(int maxThreadPoolSize); +--- src/core/src/main/java/org/jboss/wise/core/client/InvocationResult.java.orig 2015-08-16 19:27:39.775115865 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/InvocationResult.java 2015-08-16 20:01:30.717337226 +0100 +@@ -28,9 +28,9 @@ + + /** + * Holds the webservice's (JAXWS or JAXRS) invocation result's data. Normally +- * this data are kept in Map for JAXWS and a Stream or String ++ * this data are kept in Map for JAXWS and a Stream or String + * for JAXR, but implementor are free to change internal data structure. Anyway +- * it return a Map with webservice's call results, eventually ++ * it return a Map with webservice's call results, eventually + * applying a mapping to custom object using a WiseMapper passed to + * {@link #getMapRequestAndResult(WiseMapper, Map)} methods + * +@@ -62,7 +62,7 @@ + * output. It's useful when they are needed by wise's client in + * same classLoader used by smooks (i.e when wise is used to + * enrich set of objects like in ESB action pipeline) +- * @return a Map containing the result of ws calls ++ * @return a Map containing the result of ws calls + * eventually mapped using WiseMapper provided + * @throws MappingException + * rethrown exception got from provided {@link WiseMapper} +@@ -82,7 +82,7 @@ + * a WiseMapper used to map JAX-WS generated object returned by + * method call to arbitrary custom object model. It could be null + * to don't apply any kind of mappings +- * @return a Map containing the result of ws calls ++ * @return a Map containing the result of ws calls + * eventually mapped using WiseMapper provided + * @throws MappingException + * rethrown exception got from provided {@link WiseMapper} +@@ -94,7 +94,7 @@ + * return value and OUT Holders parameters are considered ; For JAXRS a Map + * contains 2 key/valuepair with keys "ContentType" and "JAXRSStream" + * +- * @return a Map containing the result of ws calls ++ * @return a Map containing the result of ws calls + * eventually mapped using WiseMapper provided + */ + public Map getResult(); +--- src/core/src/main/java/org/jboss/wise/core/client/SpiLoader.java.orig 2015-08-16 20:02:45.154200742 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/SpiLoader.java 2015-08-16 20:03:36.366794842 +0100 +@@ -52,8 +52,8 @@ + * + * 3. Finally, a default implementation class name is used. + * +- * @param propertyName +- * @param defaultFactory ++ * @param propertyName String ++ * @param defaultFactory String + * @return the instance + */ + public static Object loadService(String propertyName, String defaultFactory) { +@@ -73,7 +73,7 @@ + * Use the Services API (as detailed in the JAR specification), if + * available, to determine the classname. + * +- * @param propertyName ++ * @param propertyName String + * @return the instance + */ + public static Object loadFromServices(String propertyName) { +@@ -105,7 +105,7 @@ + /** + * Use the system property + * +- * @param propertyName ++ * @param propertyName String + * @return the instance + */ + public static Object loadFromSystemProperty(String propertyName) { +--- src/core/src/main/java/org/jboss/wise/core/client/WSDynamicClient.java.orig 2015-08-16 19:33:01.253814596 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/WSDynamicClient.java 2015-08-16 20:05:20.113998378 +0100 +@@ -32,7 +32,7 @@ + + /** + * This is the Wise core class responsible to invoke the JAX-WS tools that +- * handles wsdl retrieval & parsing. It is used to build the list of WSService ++ * handles wsdl retrieval parsing. It is used to build the list of WSService + * representing the services available in parsed wsdl. + * + * @author Stefano Maestri, stefano.maestri@javalinux.it +@@ -67,9 +67,9 @@ + * "one line of code invocation" (see "Wise-core Programmers guide" for more + * information) + * +- * @param serviceName +- * @param portName +- * @param operationName ++ * @param serviceName String ++ * @param portName String ++ * @param operationName String + * @throws ResourceNotAvailableException + * when the specified service, port or operation can not be + * found +--- src/core/src/main/java/org/jboss/wise/core/client/builder/RSDynamicClientBuilder.java.orig 2015-08-16 20:06:12.035600703 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/builder/RSDynamicClientBuilder.java 2015-08-16 20:07:13.122309350 +0100 +@@ -42,9 +42,8 @@ + * Build the {@link WSDynamicClient} with all parameters set on this class + * + * @return {@link WSDynamicClient} +- * @throws IllegalStateException +- * @throws ConnectException +- * @throws WiseRuntimeException ++ * @throws IllegalStateException Exception ++ * @throws WiseRuntimeException Exception + */ + public RSDynamicClient build() throws IllegalStateException, WiseRuntimeException; + +--- src/core/src/main/java/org/jboss/wise/core/client/factories/WSDynamicClientFactory.java.orig 2015-08-16 20:07:50.743745782 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/factories/WSDynamicClientFactory.java 2015-08-16 20:09:52.824161995 +0100 +@@ -77,12 +77,12 @@ + * Return an instance of RSDynamicClient taken from cache if possible, + * generate and initialise if not. + * +- * @param endpointURL +- * @param produceMediaTypes +- * @param consumeMediaTypes +- * @param httpMethod +- * @param userName +- * @param password ++ * @param endpointURL String ++ * @param produceMediaTypes String ++ * @param consumeMediaTypes String ++ * @param httpMethod HttpMethod ++ * @param userName String ++ * @param password String + * @return an instance of {@link RSDynamicClient} already initialized, ready + * to be called + */ +@@ -100,10 +100,10 @@ + * Return an instance of RSDynamicClient taken from cache if possible, + * generate and initialise if not. + * +- * @param endpointURL +- * @param produceMediaTypes +- * @param consumeMediaTypes +- * @param httpMethod ++ * @param endpointURL String ++ * @param produceMediaTypes String ++ * @param consumeMediaTypes String ++ * @param httpMethod HttpMethod + * @return an instance of {@link RSDynamicClient} already initialized, ready + * to be called + */ +--- src/core/src/main/java/org/jboss/wise/core/client/jaxrs/RSDynamicClient.java.orig 2015-08-16 20:10:52.281851743 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/client/jaxrs/RSDynamicClient.java 2015-08-16 20:11:25.119232678 +0100 +@@ -87,7 +87,7 @@ + /** + * Invoke JAXRS service. + * +- * @param request ++ * @param request InputStream + * @param mapper {@link WiseMapper} used to map inputObject to stream representation used to call the service + * @return {@link InvocationResult} implementation representing the result of JAXRS service + */ +@@ -97,7 +97,7 @@ + /** + * Invoke JAXRS service. + * +- * @param request ++ * @param request String + * @param mapper {@link WiseMapper} used to map inputObject to stream representation used to call the service + * @return {@link InvocationResult} implementation representing the result of JAXRS service + */ +@@ -107,7 +107,7 @@ + /** + * Invoke JAXRS service. + * +- * @param request ++ * @param request byte array + * @param mapper {@link WiseMapper} used to map inputObject to stream representation used to call the service + * @return {@link InvocationResult} implementation representing the result of JAXRS service + */ +--- src/core/src/main/java/org/jboss/wise/core/utils/IOUtils.java.orig 2015-08-16 20:12:42.670129431 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/utils/IOUtils.java 2015-08-16 20:13:12.426471724 +0100 +@@ -37,9 +37,9 @@ + /** + * True if the given type name is the source notation of a primitive or array of which. + * +- * @param outs +- * @param ins +- * @throws WiseRuntimeException ++ * @param outs OutputStream ++ * @param ins InputStream ++ * @throws WiseRuntimeException Exception + */ + public static void copyStreamAndClose( OutputStream outs, + InputStream ins ) throws WiseRuntimeException { +--- src/core/src/main/java/org/jboss/wise/core/utils/JavaUtils.java.orig 2015-08-16 20:13:41.808809712 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/utils/JavaUtils.java 2015-08-16 20:14:27.189331731 +0100 +@@ -47,10 +47,10 @@ + /** + * Load a Java type from a given class loader. + * +- * @param typeName +- * @param classLoader ++ * @param typeName String ++ * @param classLoader ClassLoader + * @return Class +- * @throws ClassNotFoundException ++ * @throws ClassNotFoundException Exception + */ + public static Class loadJavaType(String typeName, ClassLoader classLoader) throws ClassNotFoundException { + if (classLoader == null) +@@ -152,7 +152,7 @@ + * Get the corresponding wrapper type for a give primitive. Also handles + * arrays of which. + * +- * @param javaType ++ * @param javaType Class + * @return Class + */ + public static Class getWrapperType(Class javaType) { +--- src/core/src/main/java/org/jboss/wise/core/utils/ReflectionUtils.java.orig 2015-08-16 20:15:01.321724360 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/utils/ReflectionUtils.java 2015-08-16 20:15:48.690269250 +0100 +@@ -56,8 +56,8 @@ + /** + * Get setter method name of given fieldName + * +- * @param fieldName +- * @param isBoolean ++ * @param fieldName String ++ * @param isBoolean boolean + * @return String + */ + public static String setterMethodName( String fieldName, +@@ -72,8 +72,8 @@ + /** + * Get getter method name of given fieldName + * +- * @param fieldName +- * @param isBoolean ++ * @param fieldName String ++ * @param isBoolean boolean + * @return String + */ + public static String getterMethodName( String fieldName, +@@ -88,7 +88,7 @@ + /** + * Get getter method name of given field + * +- * @param field ++ * @param field Field + * @return String + */ + public static String getGetter( Field field ) { +--- src/core/src/main/java/org/jboss/wise/core/mapper/SmooksMapper.java.orig 2015-08-16 20:16:36.622820626 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/mapper/SmooksMapper.java 2015-08-16 20:17:07.101171223 +0100 +@@ -130,12 +130,12 @@ + /** + * apply this mapping to original object + * +- * @param originalObjects ++ * @param originalObjects Object + * @return Map returned is typically used to invoke webservice operations. + * To do this, beanids defined in smooks config (and used here as + * Map's keys) have to be the parameters names as defined in + * wsdl/wsconsume generated classes +- * @throws MappingException ++ * @throws MappingException Exception + */ + @SuppressWarnings("unchecked") + public Map applyMapping(Object originalObjects) throws MappingException { +--- src/core/src/main/java/org/jboss/wise/core/mapper/WiseMapper.java.orig 2015-08-16 20:17:35.974503357 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/mapper/WiseMapper.java 2015-08-16 20:18:08.076872636 +0100 +@@ -36,10 +36,10 @@ + /** + * apply this mapping to original object + * +- * @param originalObjects +- * @return the mapped object in a Map. Keys of this map normally represent symbolic name of mapped Object. For ++ * @param originalObjects Object ++ * @return the mapped object in a Map. Keys of this map normally represent symbolic name of mapped Object. For + * JAXRS conventional key used for standard key/value pairs are "ContentType" and "JAXRSStream" +- * @throws MappingException ++ * @throws MappingException Exception + */ + public Map applyMapping( Object originalObjects ) throws MappingException; + +--- src/core/src/main/java/org/jboss/wise/core/wsextensions/WSExtensionEnabler.java.orig 2015-08-16 20:18:45.654304895 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/wsextensions/WSExtensionEnabler.java 2015-08-16 20:19:02.173494917 +0100 +@@ -40,7 +40,7 @@ + * This is the call back method invoked by {@link WSEndpoint} to ask this extension to enable itself. Implementer should + * delegate the effective job to {@link EnablerDelegate} implementation for the right JAX-WS stack in use. + * +- * @param endpointInstance ++ * @param endpointInstance Object + */ + public abstract void enable( Object endpointInstance ); + +--- src/core/src/main/java/org/jboss/wise/core/wsextensions/EnablerDelegate.java.orig 2015-08-16 20:19:43.298967990 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/wsextensions/EnablerDelegate.java 2015-08-16 20:21:25.577144512 +0100 +@@ -43,43 +43,43 @@ + /** + * Sets the configFile to be used, if any + * +- * @param configFile ++ * @param configFile String + */ + public void setConfigFile(String configFile); + + /** + * Sets the configName to be used, if any + * +- * @param configName ++ * @param configName String + */ + public void setConfigName(String configName); + + /** + * +- * @param endpointInstance +- * @throws UnsupportedOperationException +- * @throws IllegalStateException ++ * @param endpointInstance Object ++ * @throws UnsupportedOperationException Exception ++ * @throws IllegalStateException Exception + */ + public void visitWSSecurity(Object endpointInstance) throws UnsupportedOperationException, IllegalStateException; + + /** + * +- * @param endpointInstance +- * @throws UnsupportedOperationException ++ * @param endpointInstance Object ++ * @throws UnsupportedOperationException Exception + */ + public void visitWSRM(Object endpointInstance) throws UnsupportedOperationException; + + /** + * +- * @param endpointInstance +- * @throws UnsupportedOperationException ++ * @param endpointInstance Object ++ * @throws UnsupportedOperationException Exception + */ + public void visitWSAddressing(Object endpointInstance) throws UnsupportedOperationException; + + /** + * +- * @param endpointInstance +- * @throws UnsupportedOperationException ++ * @param endpointInstance Object ++ * @throws UnsupportedOperationException Exception + */ + public void visitMTOM(Object endpointInstance) throws UnsupportedOperationException; + } +--- src/core/src/main/java/org/jboss/wise/core/handlers/SmooksHandler.java.orig 2015-08-16 20:22:03.163576874 +0100 ++++ src/core/src/main/java/org/jboss/wise/core/handlers/SmooksHandler.java 2015-08-16 20:22:44.312050211 +0100 +@@ -94,8 +94,8 @@ + * URI of smooks config file + * @param beans + * used for smooks BeanAccessor +- * @param client +- * @param smooksReport ++ * @param client WSDynamicClient ++ * @param smooksReport String + */ + public SmooksHandler(String smooksResource, Map beans, WSDynamicClient client, String smooksReport) { + +--- src/core/src/main/java/org/jboss/wise/smooks/decoders/DurationDecoder.java.orig 2015-08-16 20:23:25.533524389 +0100 ++++ src/core/src/main/java/org/jboss/wise/smooks/decoders/DurationDecoder.java 2015-08-16 20:23:41.323706025 +0100 +@@ -31,7 +31,6 @@ + + /** + * {@link javax.xml.datatype.Duration} data decoder. +- *

+ * Decodes the supplied string into a {@link javax.xml.datatype.Duration} String value is supposed to be milliseconds representing + * this Duration + */ +--- src/core/src/main/java/org/jboss/wise/smooks/decoders/JAXBElementDecoder.java.orig 2015-08-16 20:24:09.429029325 +0100 ++++ src/core/src/main/java/org/jboss/wise/smooks/decoders/JAXBElementDecoder.java 2015-08-16 20:25:39.462064989 +0100 +@@ -31,9 +31,8 @@ + + /** + * {@link javax.xml.datatype.Duration} data decoder. +- *

+ * Decodes the supplied string into a {@link javax.xml.bind.JAXBElement} It requires 2 parameter to build QName for JAXBElement. +- * IOW what it does under the wood is: new JAXBElement(new QName(nameSpaceURI, localPart), String.class, data); ++ * IOW what it does under the wood is: new JAXBElement(new QName(nameSpaceURI, localPart), String.class, data); + */ + @DecodeType( JAXBElement.class ) + public class JAXBElementDecoder implements DataDecoder { +--- src/core/src/main/java/org/jboss/wise/smooks/decoders/XMLGregorianCalendarDecoder.java.orig 2015-08-16 20:26:02.846333982 +0100 ++++ src/core/src/main/java/org/jboss/wise/smooks/decoders/XMLGregorianCalendarDecoder.java 2015-08-16 20:26:38.364742556 +0100 +@@ -34,14 +34,11 @@ + + /** + * {@link javax.xml.datatype.XMLGregorianCalendar} data decoder. +- *

+ * Decodes the supplied string into a {@link javax.xml.datatype.XMLGregorianCalendar} value based on the supplied " + * {@link java.text.SimpleDateFormat format}" parameter, or the default (see below). +- *

+ * The default date format used is "yyyy-MM-dd'T'HH:mm:ss" (see {@link SimpleDateFormat}). This format is based on the ISO 8601 standard as used by the XML Schema type "dateTime". +- *

+ * This decoder is synchronized on its underlying {@link SimpleDateFormat} instance. + * + * @author stefano.maestri@javalinux.it diff --git a/wise.spec b/wise.spec new file mode 100644 index 0000000..011fe2a --- /dev/null +++ b/wise.spec @@ -0,0 +1,120 @@ +%global reltag Final + +Name: wise +Version: 2.0.3 +Release: 7%{?dist} +Summary: JBoss Wise: 'Wise invokes services easily' + +License: LGPLv2+ and ASL 2.0 +URL: http://www.jboss.org/%{name} +Source0: http://download.jboss.org/%{name}/%{name}-distribution-%{version}.%{reltag}.zip +Source1: http://www.apache.org/licenses/LICENSE-2.0.txt + +# Implement abstract method setClientJar from superclass in F20+ +Patch0: %{name}-CXFConsumerImpl.patch + +Patch1: %{name}-javadoc.patch + +BuildArch: noarch + +BuildRequires: maven-local +BuildRequires: mvn(wsdl4j:wsdl4j) +BuildRequires: mvn(org.milyn:milyn-commons) +BuildRequires: mvn(org.jboss.ws:jbossws-spi) +BuildRequires: mvn(net.jcip:jcip-annotations) +BuildRequires: mvn(org.jboss.ws:jbossws-parent:pom:) +BuildRequires: mvn(org.jboss.ws:jbossws-common) +BuildRequires: mvn(org.jboss.logging:jboss-logging) +BuildRequires: mvn(org.jboss.ws:jbossws-common-tools) +BuildRequires: mvn(org.milyn:milyn-smooks-validation) +BuildRequires: mvn(org.jboss.ws.cxf:jbossws-cxf-client) + +%description +Wise is a Java framework for easily invoking webservices, which can be used as +base for zero-code webservice invocation applications. Wise can be the proper +solution when total and effective client/server decoupling through WS is +required. + +While basic JAX-WS tool for wsdl-to-java generation (like wsconsume) are great +for most Java developer usecases, the generated stub classes kind of introduce +a new (or renewed :)) level of coupling very similar to Corba IDL; by +generating statical webservice stubs you actually couple client and server. + +So what is the alternative? Writing dynamic client using dynamic +Provider/Dispatch JAX-WS API? That's possibly an option, yet not the easiest +to understand, implement and maintain in most enterprise environments. Wise +provides a different solution using dynamic mapping on JAX-WS tools generated +code. Wise allows calling a ws service by mapping a generic Object model to +JAXWS generated code. This opens up multiple Wise usage scenarios, like +zero-code WS invocation (used in JBoss ESB) or GUI driven WS invocation. + +%package javadoc +Summary: Javadoc for %{name} + +%description javadoc +API documentation for %{name}. + +%package core +Summary: JBoss Wise Core +Requires: %{name} = %{version}-%{release} + +%description core +It is a library to simplify web service invocation from a client point of view: +it aims at providing a near zero-code solution to find and parse wsdls, select +service and endpoint and call operations mapping user defined object model to +JAX-WS objects required to perform the call. + +%package core-cxf +Summary: JBoss Wise Core CXF +Requires: %{name} = %{version}-%{release} + +%description core-cxf +%{summary}. + +%prep +%setup -qn %{name}-%{version}.%{reltag}/src +cp %{SOURCE1} . + +find ../ -name '*.class' -delete +find ../ -name '*.jar' -delete + +%if 0%{?fedora} >= 20 +%patch0 +%endif + +%patch1 -p1 + +%build +# Tests fail because of different hamcrest versions +%mvn_build -s --skip-tests + +%install +%mvn_install + +%files -f .mfiles-wise +%doc LICENSE-2.0.txt +%files javadoc -f .mfiles-javadoc +%files core -f .mfiles-%{name}-core +%files core-cxf -f .mfiles-%{name}-core-cxf + +%changelog +* Fri Feb 05 2016 Fedora Release Engineering - 2.0.3-7 +- Rebuilt for https://fedoraproject.org/wiki/Fedora_24_Mass_Rebuild + +* Sun Aug 16 2015 Gerard Ryan - 2.0.3-6 +- RHBZ#1240055 FTBFS in rawhide + +* Fri Jun 19 2015 Fedora Release Engineering - 2.0.3-5 +- Rebuilt for https://fedoraproject.org/wiki/Fedora_23_Mass_Rebuild + +* Sun Jun 08 2014 Fedora Release Engineering - 2.0.3-4 +- Rebuilt for https://fedoraproject.org/wiki/Fedora_21_Mass_Rebuild + +* Tue Feb 25 2014 Gerard Ryan - 2.0.3-3 +- RHBZ#1068592: Switch to java-headless requires + +* Sat Aug 17 2013 Gerard Ryan - 2.0.3-2 +- Add BR on mvn(org.jboss.ws:jbossws-common-tools) + +* Mon Jul 29 2013 Gerard Ryan - 2.0.3-1 +- Initial package.