CSW - first time - using Java (Error with java.nio.BufferUnderflowException)

Hi there,

I am trying for the first time looking at the WebServices in Java and running into an error with the sample java codes.

For example, when using the "GettingStarted.java" code, and using CS 10 Update 13, using Eclipse and java ee-sdk_6u_3 and jre7u55 on Windows 64 bit, I got an error when trying to make the call to the getFavourites() routine.

Authenticating User...SUCESS!
Getting the user's Favourites...FAILED!
S:Server : java.nio.bufferUnderflowException

I also tried to run the CatsAtts.java sample program and got similar result:

Authenticating User...SUCESS!
Creating Category...FAILED!
S:Server : java.nio.bufferUnderflowException

I am new to Java/Eclipse and just trying to run the sample pgm as a test - would appreciate if if someone can point out what I am missing here.

Thanks in advance,
Johnny Lim

Find more posts tagged with

Comments

Jason_Smith

Hi Johnny,

Sounds like something isn't loading properly at the CWS server. Do you happen to have access to the Content Server thread logs to see what response Content Server is sending back? You would need to make sure you add the following options to your opentext.ini to get this information:

[general]

debug=2

[options]

wantLAPILogs=TRUE

Note the wantLAPILogs option does not exist in the opentext.ini by default, so you would have to add it.

Also, if you want to attach the sample program you are running here, we can verify your client code as well (although I don't expect this to be the issue, but always good to double check).

Thanks.

Johnny_Lim

Hi Jason,

Thanks for your response. Here is what I see in the thread1.log output. Let me know if you have any suggestions.

Thanks,
Johnny Lim

05/27/2014 18:14:15 =======================================
05/27/2014 18:14:15 Executing API: #3d00257f.InvokeService
05/27/2014 18:14:15        inArgs: A<1,?,'Arguments'=A<1,?,'userName'='TSTacn1',
'userPassword'='XXXXXXXXXX'>,'ServiceMethod'='AuthenticateUser','ServiceName'='A
uthentication','_ApiName'='InvokeService','_ClientVersion'='9.7.1','_ConnectionN
ame'='','_Cookie'='','_DomainName'='','_ImpersonateUserDomain'='','_LLENVIRON_AS
SOC'=A<1,?,'REMOTE_ADDR'='52.120.70.13'>,'_Request'='llweb','_UserName'='TSTacn1
','_UserPassword'='XXXXXXXXXX'>
05/27/2014 18:14:15 ------------------------------------------
05/27/2014 18:14:15 _LLENVIRON_ASSOC contains:
05/27/2014 18:14:15 REMOTE_ADDR=52.120.70.13
05/27/2014 18:14:15 End _LLENVIRON_ASSOC
05/27/2014 18:14:15 ------------------------------------------
05/27/2014 18:14:15        inArgs: A<1,?,'Arguments'=A<1,?,'userName'='TSTacn1',
'userPassword'='XXXXXXXXXX'>,'ServiceMethod'='AuthenticateUser','ServiceName'='A
uthentication','_ApiName'='InvokeService','_ClientVersion'='9.7.1','_ConnectionN
ame'='','_Cookie'='','_DomainName'='','_ImpersonateUserDomain'='','_LLENVIRON_AS
SOC'=A<1,?,'REMOTE_ADDR'='52.120.70.13'>,'_Request'='llweb','_UserName'='TSTacn1
','_UserPassword'='XXXXXXXXXX'>
05/27/2014 18:14:15       outArgs: A<1,?,'Results'='TyBsWWT0762TPscV%2BkSfFA%3D%
3D','_apiError'='','_errMsg'='','_Status'=0,'_StatusMessage'='','_TimeLogin'='27
05 14 181415'>
05/27/2014 18:14:15        status: (0)
05/27/2014 18:14:15         msecs: 31
05/27/2014 18:14:15 =======================================

I have attached Java sample test pgm (saved as mainPgm.java) that I am using, and compiling with the following command via command line:

C:\ javac -XDignore.symbol.file mainPgm.java

I think that using the -XDignore.symbol.file to overcome compliation errors see.. http://stackoverflow.com/questions/10614852/com-sun-xml-internal-ws-client-does-not-exist. If I don't use that -XDignore.symbol.file, I got compilation errors as shown below:

mainPgm.java:19: error: package com.sun.xml.internal.ws.api.message does not exist
import com.sun.xml.internal.ws.api.message.Headers;
^
mainPgm.java:20: error: package com.sun.xml.internal.ws.developer does not exist

import com.sun.xml.internal.ws.developer.WSBindingProvider;
                                        ^
mainPgm.java:123: error: cannot find symbol
        public static void setSoapHeader(WSBindingProvider bindingProvider, OTAu
thentication otAuth) throws SOAPException
                                         ^
symbol:   class WSBindingProvider
location: class mainPgm
mainPgm.java:70: error: cannot find symbol
                        setSoapHeader((WSBindingProvider) docManClient, otAuth);

                                       ^
symbol:   class WSBindingProvider
location: class mainPgm
mainPgm.java:138: error: cannot find symbol
                bindingProvider.setOutboundHeaders(Headers.create(otAuthElement)
);
                                                   ^
symbol:   variable Headers
location: class mainPgm
5 errors

Running the program,

C:\>java mainPgm
Authenticating User...SUCCESS!

Getting the user's favorites...FAILED!

S:Server : java.nio.BufferUnderflowException

I was unable to get a result for the favourites.

I am using java jdk1.7 as shown below:

C:\>java -version
java version "1.7.0_55"
Java(TM) SE Runtime Environment (build 1.7.0_55-b13)
Java HotSpot(TM) 64-Bit Server VM (build 24.55-b03, mixed mode)

and with class path as:

CLASSPATH=.;C:\Program Files\Java\jdk1.7.0_55\lib;c:\temp\cws.jar

the cws.jar file is based from the wsimport command that I already executed from CS 10 Update 13 installation, using

wsimport -keep http://localhost:8080/cws/services/Authentication?wsdl
wsimport -keep http://localhost:8080/cws/services/DocumentManagement?wsdl

and running

jar cvfM cws.jar com/opentext*

//---------------------------------------- (Begin mainPgm.java below) -----------------------

import java.util.List;

import javax.xml.namespace.QName;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPElement;
import javax.xml.soap.SOAPException;
import javax.xml.soap.SOAPHeader;
import javax.xml.soap.SOAPHeaderElement;
import javax.xml.ws.soap.SOAPFaultException;

import com.opentext.ecm.api.OTAuthentication;
import com.opentext.livelink.service.core.Authentication;
import com.opentext.livelink.service.core.Authentication_Service;
import com.opentext.livelink.service.docman.DocumentManagement;
import com.opentext.livelink.service.docman.DocumentManagement_Service;
import com.opentext.livelink.service.docman.Node;
import com.sun.xml.internal.ws.api.message.Headers;
import com.sun.xml.internal.ws.developer.WSBindingProvider;

public class mainPgm
{
// The user's credentials
public final static String USERNAME = "TSTacn1";
public final static String PASSWORD = "password";

public static void main(String[] args)
{
  // --------------------------------------------------------------------------
  // 1) Authenticate the user
  // --------------------------------------------------------------------------

  // Create the Authentication service client
  Authentication_Service authService = new Authentication_Service();
  Authentication authClient = authService.getBasicHttpBindingAuthentication();

// Store the authentication token
String authToken = null;

  // Call the AuthenticateUser() method to get an authentication token
  try
  {
   System.out.print("Authenticating User...");
   authToken = authClient.authenticateUser(USERNAME, PASSWORD);
   System.out.println("SUCCESS!\n");
  }
  catch (SOAPFaultException e)
  {
   System.out.println("FAILED!\n");
   System.out.println(e.getFault().getFaultCode() + " : " + e.getMessage());
   return;
  }

  // --------------------------------------------------------------------------
  // 2) Get the user's favorites
  // --------------------------------------------------------------------------

  // Create the DocumentManagement service client
  DocumentManagement_Service docManService = new DocumentManagement_Service();
  DocumentManagement docManClient = docManService.getBasicHttpBindingDocumentManagement();

  // Create the OTAuthentication object and set the authentication token
  OTAuthentication otAuth = new OTAuthentication();
  otAuth.setAuthenticationToken(authToken);

  // We need to manually set the SOAP header to include the authentication token
  try
  {
   setSoapHeader((WSBindingProvider) docManClient, otAuth);
  }
  catch (SOAPException e)
  {
   System.out.println("Failed to set authentication SOAP header!\n");
   System.out.println(e.getMessage());
   System.out.println(e.getStackTrace());
   return;
  }

// Store the favorites
List<Node> favorites = null;

  // Call the GetAllFavorites() method to get the user's favorites
  try
  {
   System.out.print("Getting the user's favorites...");
   favorites = docManClient.getAllFavorites();
   System.out.println("SUCCESS!\n");
  }
  catch (SOAPFaultException e)
  {
   System.out.println("FAILED!\n");
   System.out.println(e.getFault().getFaultCode() + " : " + e.getMessage());
   return;
  }

  // Output the user's favorites
  System.out.println("User's Favorites:\n");
  if (favorites.size() > 0)
  {
   for (Node node : favorites)
   {
    System.out.println(node.getName());
   }
  }
  else
  {
   System.out.println("No Favorites.");
  }
  System.out.println();

}

/**
* Sets the OTAuthentication SOAP header on the binding provider.
*
* @param bindingProvider
*            The binding provider to set the header on.
* @param otAuth
*            The OTAuthentication object containing the authentication token.
* @throws SOAPException
*/
public static void setSoapHeader(WSBindingProvider bindingProvider, OTAuthentication otAuth) throws SOAPException
{
  final String ECM_API_NAMESPACE = "urn:api.ecm.opentext.com";

// Create a SOAP header
SOAPHeader header = MessageFactory.newInstance().createMessage().getSOAPPart().getEnvelope().getHeader();

// Add the OTAuthentication SOAP header element
SOAPHeaderElement otAuthElement = header.addHeaderElement(new QName(ECM_API_NAMESPACE, "OTAuthentication"));

  // Add the AuthenticationToken SOAP element
  SOAPElement authTokenElement = otAuthElement.addChildElement(new QName(ECM_API_NAMESPACE, "AuthenticationToken"));
  authTokenElement.addTextNode(otAuth.getAuthenticationToken());

// Set the header on the binding provider
bindingProvider.setOutboundHeaders(Headers.create(otAuthElement));
}

}

---------------------------

Jason_Smith

Hi Johnny,

I just noticed that you said you are using a Content Server 10.0 system here, but your endpoints are referencing a 10.5 version of CWS. You mentioned you did your wsimport command as follows:

wsimport -keep http://localhost:8080/cws/services/Authentication?wsdl

wsimport -keep http://localhost:8080/cws/services/DocumentManagement?wsdl

But for Content Server 10.0, you should be referencing "les-services" instead of "cws", like so:

wsimport -keep http://localhost:8080/les-services/services/Authentication?wsdl

wsimport -keep http://localhost:8080/les-services/services/DocumentManagement?wsdl

Could this be your problem? Do you have a Content Server 10.5 instance on your machine as well?

Also, in your thread logs we are not seeing any requests coming through other than the AuthenticateUser request. So it does appear to be a client side issue for your DocumentManagement service requests. I'll see if I can reproduce your problem with this information and let you know what I find out.

Thanks.

Johnny_Lim

Yes, Correction i did a copy/paste for the command in the email and it did not work initially because I am using CS 10. I meant to specify the les-services as you pointed out.

I did use the commond as I don't have CS 10.5 installed, and still same error.

wsimport -keep http://localhost:8080/les-services/services/Authentication?wsdl
wsimport -keep http://localhost:8080/les-services/services/DocumentManagement?wsdl

Thanks,
Johnny

Jason_Smith

I was not able to reproduce your issue.

Can you inspect the exception coming back and get any more information from it (other than java.nio.BufferUnderflowException)?

Or do you have any useful information in the les-services.log in Tomcat?

Thanks.

Johnny_Lim

Hi Jason, here is log that I see into the rcs.log in tomcat.

The CS environment has OTDS, but I am login via Admin user for now to run the sample pgm as a test. Let me know what else I can try out.

Thanks,
Johnny

2014-05-28 12:50:47,534 DEBUG [http-8080-7] otx.OTDS : com.opentext.otds.as.Repl
ayCache - authenticator added to cache: 68620251-06b8-30e3-93c2-8e5019e4012e
2014-05-28 12:50:47,550 INFO [http-8080-7] otx.OTDS : com.opentext.otds.as.AsEn
gine - createTicket: Resource ID: ba00b86e-ead5-4de5-aa15-5ade098caa36, OTDS use
r ID: otadmin@otds.admin, Credential name: Admin, entryDN: cn=otadmin,ou=Root,ou
=otds.admin,ou=IdentityProviders,dc=identity,dc=opentext,dc=net
2014-05-28 12:50:48,455 DEBUG [http-8080-9] otx.OTDS : com.opentext.otds.client.
OtdsClient - validateTicket: WAPdACAlQxr9NnWfotgmSg%3D%3D noReplayDetection=true

2014-05-28 12:50:48,455 WARN [http-8080-9] otx.security : com.opentext.ecm.comp
onents.webservices.SecurityHandler - handleMessage(SOAPMessageContext):NOT AN IECMException:java.nio.BufferUnderflowException
2014-05-28 12:50:48,455 DEBUG [http-8080-9] otx.servicecontrol : com.opentext.ec
m.services.ServiceLocator - getService(String, Class):entry: serviceId=core/Noti
ficationService; Class=interface com.opentext.ecm.services.notification.INotific
ationService
2014-05-28 12:50:48,455 TINFO [http-8080-9] otx.notification : com.opentext.ecm.
services.notification.impl.NotificationServiceImpl - No users registered for event
2014-05-28 12:50:51,887 DEBUG [Thread-79] otx.OTDS : com.opentext.otds.client.Ot
dsClient - replay cache maintenance starts
2014-05-28 12:50:51,887 DEBUG [Thread-79] otx.OTDS : com.opentext.otds.client.Ot
dsClient - remove entry from replay cache (key=ed675f96-5e19-37e7-bf5b-cf60e7c4b
d30)

On another note, I tried to compile another program otds.java as shown below and is getting these Java compilation errors, Am I missing some CWS libraries? I only installed CS 10 Update 13, and my understanding is that this comes with CWS - is there anything else I need to do that I have missed for enable CWS?

otds.java:12: package com.opentext.ecm.services.authws does not exist
import com.opentext.ecm.services.authws.AuthenticationException_Exception;
                                       ^
otds.java:13: package com.opentext.ecm.services.authws does not exist
import com.opentext.ecm.services.authws.AuthenticationService;
                                       ^
otds.java:38: cannot find symbol
symbol : class AuthenticationService
location: class otds
                AuthenticationService otdsAuthService = new AuthenticationServic
e();
                ^
otds.java:38: cannot find symbol
symbol : class AuthenticationService
location: class otds
                AuthenticationService otdsAuthService = new AuthenticationService();
                                                            ^
otds.java:39: package com.opentext.ecm.services.authws does not exist
                com.opentext.ecm.services.authws.Authentication otdsAuthClient =
otdsAuthService.getAuthenticationPort();
                                                ^
otds.java:51: cannot find symbol
symbol : class AuthenticationException_Exception
location: class otds
                catch (AuthenticationException_Exception e)
                       ^
6 errors

---- below is sample otds.java program that I am trying out from the sample Java pgm ---

import java.util.List;

import com.opentext.ecm.api.OTAuthentication;
import com.opentext.ecm.services.authws.AuthenticationException_Exception;
import com.opentext.ecm.services.authws.AuthenticationService;
import com.opentext.livelink.service.core.Authentication;
import com.opentext.livelink.service.core.Authentication_Service;
import com.opentext.livelink.service.docman.DocumentManagement;
import com.opentext.livelink.service.docman.DocumentManagement_Service;
import com.opentext.livelink.service.docman.Node;
import com.sun.xml.internal.ws.api.message.Headers;
import com.sun.xml.internal.ws.developer.WSBindingProvider;

public class otds
{
// The user's credentials
public final static String USERNAME = "TSTacn1";
public final static String PASSWORD = "_password_";

// Namespaces for the SOAP headers
public final static String ECM_API_NAMESPACE = "urn:api.ecm.opentext.com";

public static void main(String[] args)
{
  // --------------------------------------------------------------------------
  // 1) Authenticate the user with OTDS
  // --------------------------------------------------------------------------

  // Create the OTDS Authentication service client
  AuthenticationService otdsAuthService = new AuthenticationService();
  com.opentext.ecm.services.authws.Authentication otdsAuthClient = otdsAuthService.getAuthenticationPort();

// Store the OTDS authentication token
String otdsAuthToken = null;

  // Call the authenticate() method to get an authentication token
  try
  {
   System.out.print("Authenticating User...");
   otdsAuthToken = otdsAuthClient.authenticate(USERNAME, PASSWORD);
   System.out.println("SUCCESS!\n");
  }
  catch (AuthenticationException_Exception e)
  {
   System.out.println("FAILED!\n");
   System.out.println(e.getFaultInfo().getFaultCode() + " : " + e.getMessage());
   return;
  }

  // --------------------------------------------------------------------------
  // 2) Validate the OTDS authentication token with Content Server
  // --------------------------------------------------------------------------

  // Create the CWS Authentication service client
  Authentication_Service authService = new Authentication_Service();
  Authentication authClient = authService.getBasicHttpBindingAuthentication();

// Store the CWS authentication token
String cwsAuthToken = null;

  // Call the validateUser() method to validate the OTDS authentication token with Content Server
  try
  {
   System.out.print("Validating User...");
   cwsAuthToken = authClient.validateUser(otdsAuthToken);
   System.out.println("SUCCESS!\n");
  }
  catch (SOAPFaultException e)
  {
   System.out.println("FAILED!\n");
   System.out.println(e.getFault().getFaultCode() + " : " + e.getMessage());
   return;
  }

  // --------------------------------------------------------------------------
  // 3) Get the user's favorites
  // --------------------------------------------------------------------------

  // Create the OTAuthentication object and set the authentication token
  OTAuthentication otAuth = new OTAuthentication();
  otAuth.setAuthenticationToken(cwsAuthToken);

  // We need to manually set the SOAP header to include the authentication token
  try
  {
   // Create a SOAP header
   SOAPHeader header = MessageFactory.newInstance().createMessage().getSOAPPart().getEnvelope().getHeader();

// Add the OTAuthentication SOAP header element
SOAPHeaderElement otAuthElement = header.addHeaderElement(new QName(ECM_API_NAMESPACE, "OTAuthentication"));

   // Add the AuthenticationToken SOAP element
   SOAPElement authTokenElement = otAuthElement.addChildElement(new QName(ECM_API_NAMESPACE, "AuthenticationToken"));
   authTokenElement.addTextNode(otAuth.getAuthenticationToken());

   // Set the SOAP header on the docManClient
   ((WSBindingProvider) docManClient).setOutboundHeaders(Headers.create(otAuthElement));
  }
  catch (SOAPException e)
  {
   System.out.println("Failed to set authentication SOAP header!\n");
   System.out.println(e.getMessage());
   return;
  }

// Store the favorites
List<Node> favorites = null;

}

Carsten_Kulms

This error ("BufferUnderflowException") indicates that OTDS has trouble decrypting the authentication token.If you have CWS deployed in RCS you have to authenticate with RCS authentication service as described in "Authenticating the Client" at

Johnny_Lim

Thanks for your response.

I am using CS 10 update 13, with IIS and with Tomcat running xECM and Archive Server. I do see the les-services deployed in Tomcat. I am using tomcat and has successfuly run these two commands.

wsimport -keep http://localhost:8080/les-services/services/Authentication?wsdl
wsimport -keep http://localhost:8080/les-services/services/DocumentManagement?wsdl

But I got an error with this command below for otdsws (is that command right?)

wsimport -keep http://localhost:8080//otdsws/services/Authentication?wsdl

[ERROR] http://localhost:8080/otdsws/services/Authentication?wsdl is unreachable

Failed to parse the WSDL.

I can see the otdsws deployed in tomcat. I don't have much background with Web services, I have the jdk installed, and though the tutorial and sample would be good enough to get started. This is really frustrating and I just wanted to run the sample pgm as a test and that is taking so long - must be something that I missed. Would appreciate any help.

Thanks,
Johnny

Carsten_Kulms

I think on RCS the authentication service can be reached under /ot-authws/services/Authentication i.e. you would have to use wsimport -keep http://localhost:8080/ot-authws/services/Authentication?wsdl