{"id":1575,"date":"2010-04-27T10:27:00","date_gmt":"2010-04-27T15:27:00","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=1575"},"modified":"2010-04-27T11:44:11","modified_gmt":"2010-04-27T16:44:11","slug":"wsimport-disable-wrapper-style","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=1575","title":{"rendered":"wsimport: Disable Wrapper Style"},"content":{"rendered":"

Default Behavior<\/h3><\/span>\n

In JAX-WS reference implementation, ‘wsimport’ defaults to wrapper doc\/lit style when generating Java classes from WSDL. In doing so, the generated ‘PortType’ interface class sometimes uses ‘javax.xml.ws.Holder‘ class as input parameters extensively. For example,<\/p>\n

\r\npublic void startOperation(\r\n    XMLGregorianCalendar eventTime,\r\n    OpConfigs opConfigs,\r\n    Location location, \r\n    Holder status, \r\n    Holder description) {\r\n    \/\/ TODO Auto-generated method stub\r\n    return null;\r\n  }\r\n}<\/pre>\n
Disable Wrapper Style<\/h3><\/span>\n
You can use a custom binding file to disable the default wrapper style as follows if you need to.
\n* Create a custom binding file, e.g. CustomBinding.xml.<\/p>\n
\r\n\r\n        \r\n        false<\/enableWrapperStyle>\r\n<\/bindings><\/pre>\n
* Including ‘binding’ element in ‘wsimport’ Ant task.<\/p>\n
\r\n\r\n  \r\n<\/wsimport>\r\n<\/pre>\n
After setting ‘enableWrapperStyle’ to false, the same generated operation name in PortType class becomes:<\/p>\n
\r\npublic Response startOperation(TStartOperation parameters) {\r\n  \/\/ TODO Auto-generated method stub\r\n  return null;\r\n}\r\n<\/pre>\n
For Simpler and Better Typed Binding<\/h3><\/span>\n
* Create a new JAXB binding file, e.g. simple.xjb:<\/p>\n
\r\n\r\n\r\n\r\n  \r\n  \r\n    \r\n  <\/jaxb:globalBindings>\r\n<\/jaxb:bindings>\r\n<\/pre>\n
* Specify in wsimport Ant task:<\/p>\n
\r\n\r\n  \r\n<\/wsimport>\r\n<\/pre>\n
* The operation now looks like this:<\/p>\n
\r\npublic Response startOperation(StartOperation parameters) {\r\n  \/\/ TODO Auto-generated method stub\r\n  return null;\r\n}\r\n<\/pre>\n
Parameter name ‘StartOperation’ is more readable now among benefits.<\/p>\n
References<\/h2><\/span>\n
* jaxws-ri\/docs\/customizations.html
\n* Wrapper Style<\/a>
\n* Customizing XML Schema binding<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Default Behavior In JAX-WS reference implementation, ‘wsimport’ defaults to wrapper doc\/lit style when generating Java classes from WSDL. In doing so, the generated ‘PortType’ interface class sometimes uses ‘javax.xml.ws.Holder‘ class as input parameters extensively. For example, public void startOperation( XMLGregorianCalendar … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[41],"tags":[],"class_list":["post-1575","post","type-post","status-publish","format-standard","hentry","category-jax-ws"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-pp","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1575","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1575"}],"version-history":[{"count":6,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1575\/revisions"}],"predecessor-version":[{"id":1581,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/1575\/revisions\/1581"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1575"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1575"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1575"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}