Creating Web Service Proxy
Firstly, a WebCenter Portal application needs to be created in jDeveloper. In this case I used jDeveloper 11.1.1.7.0 with WebCenter extensions. Once it is created, the following steps must be performed:
1. Create a Project for the new web service proxy. I recommend to mantain one project for web service, because there could be conflicts between them.
2. Add a Web Service Proxy Client. In this case I am using JAX-WS style.
4. Define packages for this client. In this step there could be an error regarding classes conflict, if this is the case, I recommend to leave the packages blank.
5. Select default settings in methods.
6. No policies are usually needed.
7. Continue with default values until the last window, where the actions are summarised.
Once the client is created, it should be tested by inserting code in the main method of the endpoint class (<WS_Name>EndpointClient.java) and executing it with the Run option. This quick check will determine if the connection is fine.
Implementing Web Service Methods
The next step is to create the methods that will invoke web service for the WebCenter application.
1. Create a new java class named Invoker<WS_Name>.java. This should be created in the root package of the proxy and will invoke operations generated by the client. In this class the input parameters of the service are sent and the output objects are created.
2. In this new class, an invoke function is created per service, where the input parameters are inserted in the input object, then it is sent to a function in the Enpoint class. Example:
public static WSOutputQueryMobileTransactions invokeMobileTransactions(String mobileNumber, String queryType, String startDate, String correlationID ){
MobileBalanceQueriesEndpointClient mobileTransaction = new MobileBalanceQueriesEndpointClient();
InputQueryMobileTransactions input = new InputQueryMobileTransactions();
input.setMobileNumber(mobileNumber);
input.setQueryType(queryType);
input.setStartDate(startDate);
return mobileTransaction.invokeMobileTransactions(input,correlationID);
}
3. Once the invokers are defined, in the Endpoint class functions are created where the request is built, putting together the input object from the Invoker class and other header parameters. Finally, the request is sent to the Soap.java class which communicate with the web service and return its response. Example:
public static WSOutputQueryMobileTransactions invokeMobileTransactions ( InputQueryMobileTransactions input,String correlationID){
mobileBalanceQueriesServiceagent = new MobileBalanceQueriesServiceagent();
Soap soap = mobileBalanceQueriesServiceagent.getMobileBalanceQueriesEndpoint();
((BindingProvider)soap).getRequestContext().put(BindingProvider.ENDPOINT_ADDRESS_PROPERTY , Properties.getInstance().getValues().get("URL_ENDPOINT_MOBILE") + "/Service/MobileBalanceQueries.serviceagent/MobileBalanceQueriesEndpoint/QueryInvoiceValue");
// General Request
WSInputQueryMobileTransactions request = new WSInputQueryMobileTransactions();
// Header parameters are created and added
WSRequestHeader cabecera = new WSRequestHeader();
WSRequestHeader.System system = new WSRequestHeader.System();
system.setCorrelationID(correlationID);
system.setValue("Portal");
system.setProcessingServer("Test");
cabecera.setSystem(system);
// Header and input parameters are put together
request.setWSRequestHeader(cabecera);
request.setInputQueryMobileTransactions(input);
//Web Service is invoked with the request
return soap.queryMobileTransactions(request);
}
4. The main method in the Endpoint can be used to test the functions. Example:
public static void main(String[] args)
{
try
{
WSOutputQueryInvoiceValue resp = new MobileBalanceQueriesEndpointClient().invokeInvoiceValue("3057000973", "1");
System.out.println(resp.getWSResponseHeader().getService().getStatus());
}
catch(Exception e)
{
e.printStackTrace();
}
}
Eventually, a JAR library needs to be generated from the project and it will be added to the WebCenter Portal application, where web services will be invoked via the Invoker class.
References
Tutorial: Creating a Web Service Proxy
Creating Web Services Proxy in JDeveloper
