CSSDK APIs

TS741, Win Ser 8

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

1) Are CSSDK APIs only interfaces OR do they contain concrete classes ?

When I am looking at hava doc, they are all interfaces. But at the same time, there must be concrete classes also, which throw CSClient object.

2) I dont see any of these methods or classes defined. Which are te concrete classes and where can I find details of methods of these classes ?

Find more posts tagged with

Comments

Adam Stoller

If you're truly looking at the CSSDK Java Docs - you should be able to see both classes and interfaces - if not, you're either looking at the wrong stuff or you're not looking in the right place in the right stuff.

Rick Poulin

rutu wrote:
I dont see any of these methods or classes defined. Which are te concrete classes and where can I find details of methods of these classes ?

You seem to be missing the point of interfaces. Yes, there's obviously implementations of those interfaces but you shouldn't need to care *how* they work and your code certainly should not be making any assumptions or have dependencies based on those implementations. So what are you actually looking for?

FYI - The implementation of those classes is very different depending on whether you're using the Java or the SOAP connector. From that, you should be able to figure out which JAR contains those implementations.

Bowker

Jumping to the end game - are you looking for help creating a CSClient object?

This is some example code we've been running for more than a decade. This only works if run on the same server as TeamSite. The "get trusted client" only works if run on localhost. If you want to use the SOAP interface you need to change the local.properties file and you can't use getClientForTrustedUser

local.properties:

# creates a CS JNI factory
com.interwoven.cssdk.factory.CSFactory=com.interwoven.cssdk.factory.CSJavaFactory
cssdk.cfg.path=(path)/teamsite/cssdk/cssdk.cfg
keystore.location=(path)/TeamSite/servletd/conf/ssl_cert



Sample "helloworld" type of app.


import com.interwoven.cssdk.factory.*;
import com.interwoven.cssdk.common.*;
import com.interwoven.cssdk.access.*;
import com.interwoven.cssdk.filesys.*;
import com.interwoven.cssdk.workflow.*;
import java.util.*;
import java.io.*;

public class CSHelloWorld {
	public static void main(String[] args) throws Exception {

		(new CSHelloWorld()).process();
	}

	public void process() throws Exception {
		CSFactory	csFactory = null;
		CSClient	csClient = null;
		String		name = null;
		Properties props = new Properties();

		try {
			props.load(new FileInputStream("config/local.properties"));
		} catch (FileNotFoundException fnf) {
			System.out.println(" The properties file was not found");
		}
		catch (IOException io) {
			System.out.println(" Some type of I/O error occurred trying to get properties file.");
		}

		csFactory = CSFactory.getFactory(props);

		name = csFactory.getClass().getName();

		System.out.println(" Factory of type " + name + " created\n\n");


		String username = "some valid user name";
		String application = "CSHelloWorld";
		try {


			System.out.println("username: " + username);
			System.out.println("application: " + application);
			System.out.println("ldg: " + Locale.getDefault());

			csClient = csFactory.getClientForTrustedUser( username, "", Locale.getDefault(), application, null );

			System.out.println("Completed getting csClient " + csClient );


			// at this point you have a valid CSClient


		} catch (CSAuthenticationException ae) {
			System.out.print("\nAuthentication exception thrown: ");
			switch (ae.getErrorCode()) {
				case CSAuthenticationException.AUTH_ERR: System.out.println("Authorization Error");
					 break;
				case CSAuthenticationException.EXCEPTION_ID: System.out.println("Exception of some kind");
					 break;
				case CSAuthenticationException.NODOMAIN_ERR: System.out.println("No domain specified");
					 break;
				case CSAuthenticationException.NOROLEAUTH_ERR: System.out.println("Not authorized for role specified");
					 break;
				case CSAuthenticationException.PWDACCOUNTDISABLED_ERR: System.out.println("Account disabled");
					 break;
				case CSAuthenticationException.PWDACCOUNTLOCKEDOUT_ERR: System.out.println("Account locked out");
					 break;
				case CSAuthenticationException.PWDACCOUNTRESTRICTION_ERR: System.out.println("Account currently restricted");
					 break;
				case CSAuthenticationException.PWDINVALIDLOGONHOURS_ERR: System.out.println("Account not authorized for this time");
					 break;
				case CSAuthenticationException.PWDMUSTCHANGE_ERR: System.out.println("Password must be changed before continuing");
					 break;
				case CSAuthenticationException.PWDPASSWORDEXPIRED_ERR: System.out.println("Password has expired");
					 break;
				case CSAuthenticationException.SESSIONSTR_CREATION_ERR: System.out.println("Session String Creation error");
					 break;
				case CSAuthenticationException.WRONGUSERPWD_ERR: System.out.println("Password is incorrect or username does not exist");
					 break;
				case 925: System.out.println("User is not authorized to access TeamSite/ECMS");
					 break;
				default : System.out.println("Unknown Authorization error: " + ae.getErrorCode());
			}
			System.out.println("Error trying to get trusted user.  Error is (" + ae.getErrorCode() + ") ");
		} catch (CSInvalidRoleException ir) {
			System.out.println("Invalid role exception trying to get trusted access");
		} catch (CSRemoteException re) {
			System.out.println("Remote Exception thrown trying to get trusted access");
		} catch (CSException e) {
			System.out.println("Some CS exception that was unexpected was thrown");
		}
}