unlimited.fc.server.api

Class FCServer

java.lang.Object

unlimited.fc.server.api.FCServer

All Implemented Interfaces:

FCServerIfc, FCServerIfcExtended

public class FCServer
extends java.lang.Object
implements FCServerIfcExtended

Title: FileCatalyst Direct Server API

Description: Provides server-side API execute remote administrations calls to a FileCatalyst Server

 - - - - - - - - - - - - - - -
 API USAGE:
 - - - - - - - - - - - - - - -
 
 

 Example below is a sample code where the application tries to create a user and
 wrapps up logic for reconnection attempts should the communication between the ServerAPI
 and the Server be severed.

 // Call to setup initial connection to FileCatalyst Server
 public void init() throws Exception {
   FCServer fcserver = new FCServer();
   // if you are creating multiple instances of an FCServer in a multi-threaded environment
   // use an instance of FCServerShared instead
   // FCServerIfcExtended fcserver = new FCServerShared();
   // 
   
   // ---connection parameters---
   fcserver.setHostname("localhost");
   fcserver.setPort(12400);
   fcserver.setUserName("admin");
   fcserver.setPassword("system");
   // connect with the default timeout of 0
   fcserver.connect();
 }

 // attempts a reconnection
 private void reconnect () throws Exception {
   try {
     fcserver.disconnect();
   } catch (Exception e) {
   }
   // connect with the default timeout of 0
   fcserver.connect();
 }

 //
 // Method to modify login credentials for a user.  If the user does not yet exist, create the
 // user as well.
 // @param fcUserName FTP Login name
 // @param fcPassword Password the user wants to have
 // @throws Exception If you cannot connect to the server after 3 attempts, or the server is not allowing you to
 //                   create/modify the user.
 //
 public void createOrModifyUserCredentials(String fcUserName, String fcPassword) throws Exception {
   // Get the FileCatalyst user.
   int MAXATTEMPTS = 3;
   UserContainer fcUser = null;
   int retryAttempts = 0;
   while (fcUser == null && retryAttempts < MAXATTEMPTS ) {
     // try to connect if we've lost the connection
     if (!fcserver.isConnected()) {
       reconnect();
     }
     try {
       fcUser = fcserver.getUser(fcUserName);
       if (fcUser == null) {
         // null return indicates user does not exist -- create
         fcserver.addUser(fcUserName, fcPassword);
         // test to see if the user is really there
         fcserver.resynchConfigurationFiles();
         fcUser = fcserver.getUser(fcUserName);
         if (fcUser == null) {
           throw new Exception("FileCatalyst user could not be created with user name '" + fcUserName + "'");
         }
         return;
       } else {
         fcserver.modUserPassword(fcUserName, fcPassword);
         return;
       }
     } catch (Exception e) {
       // conection foobared.  Let's try again
       retryAttempts++;
     }
   }
   throw new Exception("Cannot connect to FCServer, reached max attempts");
}


 Other examples are found below:

   // execute required remote commands (each command invokes a remote call)
   fcserver.addUser("bob", "12345");
   fcserver.setUserEnable("bob", false);
   fcserver.modUserPassword("bob", "abcde");

   // modify several attributes for user (remote call only fired off by modifyUser() method)
   UserContainer userCon = fcserver.getUser("bob");
   userCon.setFileReadPermissions(false);
   userCon.setFullName("Bobby Joe");
   userCon.setPriority(UserContainer.USERPRIORITY_LOW); //high
   System.out.println("Account will expire: " + userCon.getAccountExpiry());
   userCon.setHomeDIR("Z:/data/bob/12345/");
   fcserver.modifyUser(userCon);

   // force a resynch for configuration files and user data to server (instead of waiting for triggered response in 1-2 seconds)
   fcserver.resynchConfigurationFiles();

   // slightly more destructive methods
   fcserver.killSessionByUserId("bob");
   fcserver.delUser("bob");
   fcserver.killAllSessions();
 

Copyright: Copyright (c) 2009

Company: Unlimi-Tech Software Inc.

Since:

v2.7.1

Version:

1.0

Author:

Chris Bailey, Christian Charette

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.util.logging.Logger	logger

Fields inherited from interface unlimited.fc.server.api.FCServerIfc

PRODUCT

Constructor Summary

Constructors

Constructor and Description
FCServer() Default Contructor

Method Summary

Modifier and Type	Method and Description
void	addTemporaryToken(java.lang.String username, java.lang.String token) Add a temporary password token for a user.
void	addTempUser(java.lang.String newusername, java.lang.String newuserpass) Adds a temporary FC web user to the system.
void	addTempUser(java.lang.String newusername, java.lang.String newuserpass, java.lang.String newhomedir) Adds a temporary FC web user to the system.
void	addTempUser(java.lang.String newusername, java.lang.String newuserpass, java.lang.String newhomedir, int userType) Deprecated. Adds a temporary user to the system. No setting of any userType will be respected by this method, userType will always default to a temporary FC web user that has remote directory browsing privileges. Method has been solely kept for legacy reasons.
void	addUser(java.lang.String newusername, java.lang.String newuserpass) Creates a new user on the remote FC server
void	addUser(java.lang.String newusername, java.lang.String newuserpass, java.lang.String newhomedir) Creates a new user on the remote FC server with a home directory
void	addUserGroup(UserGroupContainer group) Add a new UserGroupContainer to the system.
java.lang.String	addVirtualFolder(VirtualFolderContainer virtualFolder) Add a new VirtualFolderContainer to the system.
void	clearBlockedUser(java.lang.String username) Command to the server to clear a temporarily blocked user from being able to login
void	connect() Default connect.
void	connect(java.lang.String hostname, int port, java.lang.String adminuser, java.lang.String adminpass) Connect with the arguments provided.
void	connect(java.lang.String hostname, int port, java.lang.String adminuser, java.lang.String adminpass, int connectTimeoutSec) Connect with the arguments provided.
void	connectNoStatus() Special connect process that disables the status client.
void	deleteTemporaryToken(java.lang.String username, java.lang.String token) Deletes temporary password token for a user.
void	deleteUserGroup(java.lang.String groupName) Deletes the UserGroupContainer with the given name.
void	deleteVirtualFolder(java.lang.String virtualFolderName) Deletes the VirtualFolderContainer with the given name.
void	delUser(java.lang.String delusername) Deletes a user on the remote FC server
void	delUser(java.lang.String delusername, boolean deleteHomeDirectory) Deletes a user on the remote FC server and the user's home dir.
void	disconnect() Disconnects from the FileCatalyst Direct Server
void	enableUserGroup(java.lang.String groupName) Enables the UserGroup with the given name.
java.util.Collection<UserContainer>	getAllUsers()
java.util.LinkedList<ClientSessionContainer>	getClientSessions() Gets the list of sessions currently running on FileCatalyst Server.
unlimited.fc.com.ConfigSourceIfc<unlimited.fc.server.FileCatalystServerInterface>	getConfigSource() Method used for testing and integration with JUnit.
int	getDefaultIdleTime() Returns the default time
java.util.Collection<FolderGroupCanAccess>	getFoldersLinkedToGroup(java.lang.String groupname) Return a list view of folders that is linked to a group along with their permissions Each entry contains a specific folder the folder has access to, and includes permissions granted to the group.
java.util.Collection<FolderUserCanAccess>	getFoldersLinkedToUser(java.lang.String userName) Returns a list view of links connecting a folder to a user.
java.util.Collection<ResourceGrantedToFolder>	getGroupsLinkedToFolder(java.lang.String virtualFolderName) Return a list of groups that is linked to a folder along with their permissions.
java.util.Collection<java.lang.String>	getGroupsLinkedToUser(java.lang.String userName) Returns group collection linked to user name.
java.lang.String	getHostname() Returns the IP address / hostname of the server
java.net.URI	getHTMLAdminURL(boolean bypassServerConfigs) Returns the current HTML admin URL when called.
int	getHTTPPort() Get http port.
java.lang.String	getLicenseString() Returns the server license string
java.lang.String	getPassword() Returns the password of the server
PermissionsContainer	getPermissionsForGroupAndFolder(java.lang.String groupname, java.lang.String foldername) Return a permission container that describes the relationship between the group and folder.
PermissionsContainer	getPermissionsForUserAndFolder(java.lang.String userName, java.lang.String virtualFolderName) Permission list that a user has regarding a folder.
int	getPort() Returns the port of the server
int	getReceiveRateKbps() Shows kbps rates (receive) of the server
java.lang.String	getRequestString() Returns the server request string
int	getTotalRateKbps() Shows kbps rates (total) of the server
int	getTransmitRateKbps() Shows kbps rates (transmit) of the server
UserContainer	getUser(java.lang.String username) Get user information from the FileCatalyst Server.
int	getUserCount() Returns the current amount of users that are on the system
UserGroupContainer	getUserGroup(java.lang.String groupName) UserGroupContainer associated with the entered name.
java.util.Collection<UserGroupContainer>	getUserGroups() List of UserGroupContainer.
java.lang.String	getUsername() Returns the username of the server
java.util.Collection<unlimited.fc.entity.user.User>	getUsers() Returns the current users on the server
java.util.Collection<ResourceGrantedToFolder>	getUsersLinkedToFolder(java.lang.String virtualFolderName) Return a list of users linked to a folder
java.util.Collection<java.lang.String>	getUsersLinkedToGroup(java.lang.String groupName) Returns user names linked to group name.
VirtualFolderContainer	getVirtualFolder(java.lang.String virtualFolderName) Returns the VirtualFolderContainer associated with the entered name.
java.util.Collection<VirtualFolderContainer>	getVirtualFolders() Returns the VirtualFolders.
boolean	isConnected() Tests to see if the ServerAPI is connected to the RemoteAdmin.
boolean	isStatusClientDisabled() Returns whether or not the status client is disabled
boolean	isUserBlocked(java.lang.String username) Used to find out if a user is marked as temporarily blocked by system.
void	killAllSessions() Kill all connected user sessions on the system
void	killSessionBySessionId(java.lang.String sessionID) Kill specific session connected to the system
void	killSessionByUserId(java.lang.String username) Kill specific users connected to the system
void	linkGroupAndFolder(java.lang.String groupname, java.lang.String foldername, PermissionsContainer permission) Create access for a group to a virtual folder with a specified permission set.
void	linkUserAndFolder(java.lang.String userName, java.lang.String virtualFolderName, PermissionsContainer permission) Links a user to a virtual folder with given permissions
void	linkUserAndGroup(java.lang.String userName, java.lang.String groupName) Links the User and the UserGroupContainer with the given names.
java.lang.String[]	listUserNames() Return user name list on the remote FC server
UserContainer[]	listUsers() Return list of UserContainers from the remote FC server
void	modifyUser(UserContainer modifiedUserContainer) Modify a user on the remote server.
void	modifyUserGroup(UserGroupContainer group) Modifies the group with the name group.getName with the values of group.
void	modifyVirtualFolder(VirtualFolderContainer folder) Modifies the virtual folder with with with the given name.
void	modUserPassword(java.lang.String username, java.lang.String newpassword) Modify a user's password on the remote FC server
void	resetAllOverrides() Resets all bandwidth/priority overrides back to default values.
void	resynchConfigurationFiles() Configuration or user changes normally prompt a resynchronization between the Server and the RemoteAdmin.
void	setDefaultIdleTime(int idleTime) Sets the default idle time to whatever value is specified
void	setDeliveryTime(java.lang.String sessionID, long deliveryTime) Sets a delivery time for a given client session.
void	setHostname(java.lang.String server) Sets the hostname on the server
void	setLicenseString(java.lang.String newLicense) Sets the server license key
void	setOverrideBandwidth(java.lang.String sessionID, int bandwidthKbps) Sets an override bandwidth for a given client session.
void	setOverridePriority(java.lang.String sessionID, int priority) Sets an override priority for a given client session.
void	setPassword(java.lang.String password) Sets the password on the server
void	setPort(int port) Sets the port on the server
void	setStatusClientDisabled(boolean newVal) for testing.
void	setUserEnable(java.lang.String username, boolean enabled) Allows enabling or disabling users on the remote FC server
void	setUserName(java.lang.String username) Sets the user name on the server
void	unlinkGroupAndFolder(java.lang.String groupname, java.lang.String foldername) Remove access of a group to a virtual folder.
void	unlinkUserAndFolder(java.lang.String userName, java.lang.String virtualFolderName) Unlinks a user to a virtual folder.
void	unlinkUserAndGroup(java.lang.String userName, java.lang.String groupName) Unlinks the User and the UserGroupContainer with the given names.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface unlimited.fc.server.api.FCServerIfcExtended

addTempUser, addUser, addUserSanity, createVirtualDownloadLinksForTheUser, createVirtualDownloadLinksForTheUser, createVirtualLinkForUserOnServer, getHTMLAdminURL, getIP, getWebServerBaseURL, translateToIP, translateToIPLazy, validateUserAdded

Field Detail

logger

protected static java.util.logging.Logger logger

Constructor Detail

FCServer

public FCServer()

Default Contructor

Method Detail

connectNoStatus

public void connectNoStatus()
                     throws java.lang.Exception

Special connect process that disables the status client. Can be used with CLI to improve performance and reduce the calls required to get status information back from the server. NOT recommended with API use, as session information is not gathered, and all configuration values must be manually resynchronized before modification/commit.

Specified by:

connectNoStatus in interface FCServerIfc

Throws:

java.lang.Exception

connect

public void connect()
             throws java.lang.Exception

Default connect. Assume the privage variables have already been set.

Specified by:

connect in interface FCServerIfc

Throws:

java.lang.Exception

connect

public void connect(java.lang.String hostname,
                    int port,
                    java.lang.String adminuser,
                    java.lang.String adminpass)
             throws java.lang.Exception

Connect with the arguments provided. This will set the internal values for the listed parameters. It will also set the timeout to 0, which is interpreted as an infinite timeout. The connection will then block until established or an error occurs.

Specified by:

connect in interface FCServerIfc

Parameters:

hostname - IP address of the server that you wish to connect to

port - Port of the server that you wish to connect to

adminuser - Administrator user name of the server that you are connecting to

adminpass - Administrator password of the server that you are connecting to

Throws:

java.lang.Exception

connect

public void connect(java.lang.String hostname,
                    int port,
                    java.lang.String adminuser,
                    java.lang.String adminpass,
                    int connectTimeoutSec)
             throws java.lang.Exception

Connect with the arguments provided.

Parameters:

hostname - IP address of the server that you wish to connect to

port - Port of the server that you wish to connect to

adminuser - Administrator user name of the server that you are connecting to

adminpass - Administrator password of the server that you are connecting to

connectTimeout - int timeout before returning an error on connection (if server is not there). < 0 implies JAVA timeout defaults.

Throws:

java.lang.Exception

disconnect

public void disconnect()
                throws java.lang.Exception

Disconnects from the FileCatalyst Direct Server

Specified by:

disconnect in interface FCServerIfc

Throws:

java.lang.Exception

getHTTPPort

public int getHTTPPort()

Get http port.

Specified by:

getHTTPPort in interface FCServerIfc

Returns:

http port if http enable, otherwise return 0.

getHTMLAdminURL

public java.net.URI getHTMLAdminURL(boolean bypassServerConfigs)
                             throws java.lang.Exception

Description copied from interface: FCServerIfcExtended

Returns the current HTML admin URL when called. Throws exception if the administration can't be properly used.

Specified by:

getHTMLAdminURL in interface FCServerIfcExtended

Parameters:

bypassServerConfigs - - set to true ignores masquerades and bind all interface on the server and returns an URL that can be used to connect to the HTML Admin

Returns:

URI for the current HTML administration

Throws:

java.lang.Exception - Thrown if remote admin is disabled, if web access is disabled, or the web server can't be reached.

getUsername

public java.lang.String getUsername()

Returns the username of the server

Specified by:

getUsername in interface FCServerIfc

Returns:

Server username

getPassword

public java.lang.String getPassword()

Returns the password of the server

Specified by:

getPassword in interface FCServerIfc

Returns:

Server password

getHostname

public java.lang.String getHostname()

Returns the IP address / hostname of the server

Specified by:

getHostname in interface FCServerIfc

Returns:

Server Hostname

getPort

public int getPort()

Returns the port of the server

Specified by:

getPort in interface FCServerIfc

Returns:

Server port

setUserName

public void setUserName(java.lang.String username)

Sets the user name on the server

Specified by:

setUserName in interface FCServerIfc

Parameters:

username - New username to set

setPassword

public void setPassword(java.lang.String password)

Sets the password on the server

Specified by:

setPassword in interface FCServerIfc

Parameters:

password - New password to set

setHostname

public void setHostname(java.lang.String server)

Sets the hostname on the server

Specified by:

setHostname in interface FCServerIfc

Parameters:

server - New hostname to set

setPort

public void setPort(int port)

Sets the port on the server

Specified by:

setPort in interface FCServerIfc

Parameters:

port - New port to set

resynchConfigurationFiles

public void resynchConfigurationFiles()
                               throws java.lang.Exception

Configuration or user changes normally prompt a resynchronization between the Server and the RemoteAdmin. This is normally performed automatically using a trigger in the the session table, but can also be manually launched via this command.

Specified by:

resynchConfigurationFiles in interface FCServerIfc

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

isConnected

public boolean isConnected()

Tests to see if the ServerAPI is connected to the RemoteAdmin. .

Specified by:

isConnected in interface FCServerIfc

Returns:

True if the connection is setup and works (NOOP command returns reply from server), false if the connection is not currently working.

listUserNames

public java.lang.String[] listUserNames()
                                 throws java.lang.Exception

Return user name list on the remote FC server

Specified by:

listUserNames in interface FCServerIfc

Returns:

Array of user names found on user list

Throws:

java.lang.Exception

listUsers

public UserContainer[] listUsers()
                          throws java.lang.Exception

Return list of UserContainers from the remote FC server

Specified by:

listUsers in interface FCServerIfcExtended

Returns:

Array of users found on user list

Throws:

java.lang.Exception - If unable to convert user into user container (user table modified while getting user list)

addUser

public void addUser(java.lang.String newusername,
                    java.lang.String newuserpass)
             throws java.lang.Exception

Creates a new user on the remote FC server

Specified by:

addUser in interface FCServerIfc

Parameters:

newusername - Username of the new user to add

newuserpass - Password of the new user to add

Throws:

java.lang.Exception - If the user cannot be created on the remote system

addUser

public void addUser(java.lang.String newusername,
                    java.lang.String newuserpass,
                    java.lang.String newhomedir)
             throws java.lang.Exception

Creates a new user on the remote FC server with a home directory

Specified by:

addUser in interface FCServerIfc

Parameters:

newusername - Username of the new user to add

newuserpass - Password of the new user to add

newhomedir - Custom home directory of the new user

Throws:

java.lang.Exception - If the user cannot be created on the remote system

delUser

public void delUser(java.lang.String delusername)
             throws java.lang.Exception

Deletes a user on the remote FC server

Specified by:

delUser in interface FCServerIfc

Parameters:

delusername - String Username that is to be removed from the database.

Throws:

java.lang.Exception - If the user cannot be deleted on the remote system

delUser

public void delUser(java.lang.String delusername,
                    boolean deleteHomeDirectory)
             throws java.lang.Exception

Deletes a user on the remote FC server and the user's home dir.

Specified by:

delUser in interface FCServerIfc

Parameters:

delusername - String Username that is to be removed from the database.

deleteHomeDirectory - Whether or not the home directory should also be deleted

Throws:

java.lang.Exception - If the user cannot be deleted on the remote system

setUserEnable

public void setUserEnable(java.lang.String username,
                          boolean enabled)
                   throws java.lang.Exception

Allows enabling or disabling users on the remote FC server

Specified by:

setUserEnable in interface FCServerIfc

Parameters:

username - User to access on the server

enabled - Whether or not the user is enabled

Throws:

java.lang.Exception - If the user cannot be modified on the remote system

clearBlockedUser

public void clearBlockedUser(java.lang.String username)
                      throws java.lang.Exception

Command to the server to clear a temporarily blocked user from being able to login

Parameters:

username - Username of the user you would like to clear

Throws:

java.lang.Exception

isUserBlocked

public boolean isUserBlocked(java.lang.String username)

Used to find out if a user is marked as temporarily blocked by system.

Parameters:

username - Username of the user that you would to know if they are blocked

Returns:

Ttrue if user is blocked, false if not

modUserPassword

public void modUserPassword(java.lang.String username,
                            java.lang.String newpassword)
                     throws java.lang.Exception

Modify a user's password on the remote FC server

Specified by:

modUserPassword in interface FCServerIfc

Parameters:

username - Username of the user you would like to modify the password for

newpassword - The new password that you would like to set

Throws:

java.lang.Exception - If the user cannot be modified on the remote system

addTemporaryToken

public void addTemporaryToken(java.lang.String username,
                              java.lang.String token)
                       throws java.lang.Exception

Add a temporary password token for a user. Allows you to create admin temporary access to login as a user without knowing the full user's credentials. Temporary tokens on the server by default are allowed to login a maximum of 10 times (enough to complete a transfer with somewhat unreliable network) within a span of 30 minutes. Afterwards, the token expires and subsequent logins are disallowed. The default values (10 connection attempts, 30 minute expiry) can be altered on the server by adding in the following values on fcconf.conf file: FCServer.server.config.user.tmp.login.expirytime.minutes=30 FCServer.server.config.user.tmp.login.max.connections=10

Specified by:

addTemporaryToken in interface FCServerIfc

Parameters:

username - Username of user

token - Login token

Throws:

java.lang.Exception - If the user cannot be modified on the remote system

deleteTemporaryToken

public void deleteTemporaryToken(java.lang.String username,
                                 java.lang.String token)
                          throws java.lang.Exception

Deletes temporary password token for a user. Allows you to create admin temporary access to login as a user without knowing the full user's credentials.

Specified by:

deleteTemporaryToken in interface FCServerIfc

Parameters:

username - Username of the user you would like to delete the token from

token - Token that you wish to delete

Throws:

java.lang.Exception - If the user cannot be modified on the remote system

getUser

public UserContainer getUser(java.lang.String username)

Get user information from the FileCatalyst Server. Used to extract specific information from a user object, or can have values modified and sent back to the server using modifyUser() method. Actually acts like more of a factory, as it queries the inner user management classes to see if an existing user is available with the username defined,

Specified by:

getUser in interface FCServerIfc

Parameters:

username - Unique username.

Returns:

UserContainer if user exists, null if user does not exist on the server.

modifyUser

public void modifyUser(UserContainer modifiedUserContainer)
                throws InvalidArgumentException,
                       java.lang.Exception

Modify a user on the remote server. Note that the username in the modifiedUserContainer must match an existing user, as it is used to match up the real user stored in the database. Modification of the username is not a permitted action in FileCatalyst Server -- you must create a new user and delete the old user.

Specified by:

modifyUser in interface FCServerIfc

Parameters:

modifiedUserContainer - User container which has values already modified.

Throws:

InvalidArgumentException - If user does not exist on the server

java.lang.Exception - if remote procedure call fails between API and the FC Server

addUserGroup

public void addUserGroup(UserGroupContainer group)
                  throws java.lang.Exception

Add a new UserGroupContainer to the system. Will throw exceptions if the UserGroupContainer does not exist or if the name is already taken.

Specified by:

addUserGroup in interface FCServerIfc

Parameters:

UserGroupContainer - A new user group.

Throws:

java.lang.Exception - *

getUserGroup

public UserGroupContainer getUserGroup(java.lang.String groupName)
                                throws java.lang.Exception

UserGroupContainer associated with the entered name. If no such named user group exists, the method returns null.

Specified by:

getUserGroup in interface FCServerIfc

Parameters:

groupName - Name of group you wish to retrieve

Returns:

UserGroupContainer with the given name, or null.

Throws:

java.lang.Exception

getUserGroups

public java.util.Collection<UserGroupContainer> getUserGroups()
                                                       throws java.lang.Exception

List of UserGroupContainer. If no groups exists, the method returns an empty collection.

Specified by:

getUserGroups in interface FCServerIfc

Returns:

Collection with the given name, or null.

Throws:

java.lang.Exception

modifyUserGroup

public void modifyUserGroup(UserGroupContainer group)
                     throws java.lang.Exception

Modifies the group with the name group.getName with the values of group. Note that modification of the group name is not permitted in FileCatalyst Server.

Specified by:

modifyUserGroup in interface FCServerIfc

Parameters:

group - User group that you would like to modify

Throws:

java.lang.Exception

deleteUserGroup

public void deleteUserGroup(java.lang.String groupName)
                     throws java.lang.Exception

Deletes the UserGroupContainer with the given name. all relationships associated with this group will be deleted.

Specified by:

deleteUserGroup in interface FCServerIfc

Parameters:

groupName - Given user group that you would like to delete

Throws:

java.lang.Exception

enableUserGroup

public void enableUserGroup(java.lang.String groupName)
                     throws java.lang.Exception

Enables the UserGroup with the given name. all relationships associated with this group will be deleted.

Specified by:

enableUserGroup in interface FCServerIfc

Parameters:

groupName - User group name that you would like to enable

Throws:

java.lang.Exception

linkUserAndGroup

public void linkUserAndGroup(java.lang.String userName,
                             java.lang.String groupName)
                      throws java.lang.Exception

Links the User and the UserGroupContainer with the given names.

Specified by:

linkUserAndGroup in interface FCServerIfc

Parameters:

userName - User that you would like to link

groupName - User Group that you would like to link to

Throws:

java.lang.Exception

unlinkUserAndGroup

public void unlinkUserAndGroup(java.lang.String userName,
                               java.lang.String groupName)
                        throws java.lang.Exception

Unlinks the User and the UserGroupContainer with the given names.

Specified by:

unlinkUserAndGroup in interface FCServerIfc

Parameters:

userName - User that you would like to unlink

groupName - User Group that you would like to unlink from

Throws:

java.lang.Exception

getUsersLinkedToGroup

public java.util.Collection<java.lang.String> getUsersLinkedToGroup(java.lang.String groupName)
                                                             throws java.lang.Exception

Returns user names linked to group name.

Specified by:

getUsersLinkedToGroup in interface FCServerIfc

Parameters:

groupName - Name of user group that you wish to retrieve the users for

Throws:

java.lang.Exception

getGroupsLinkedToUser

public java.util.Collection<java.lang.String> getGroupsLinkedToUser(java.lang.String userName)
                                                             throws java.lang.Exception

Returns group collection linked to user name.

Specified by:

getGroupsLinkedToUser in interface FCServerIfc

Parameters:

userName - Username of the user that you would like the groups for

Throws:

java.lang.Exception

addVirtualFolder

public java.lang.String addVirtualFolder(VirtualFolderContainer virtualFolder)
                                  throws java.lang.Exception

Add a new VirtualFolderContainer to the system. Will throw exceptions if the VirtualFolderContainer does not exist or if the name is already taken. *

Specified by:

addVirtualFolder in interface FCServerIfc

Parameters:

virtualFolder - A new virtualFolder.

Throws:

java.lang.Exception - *

getVirtualFolder

public VirtualFolderContainer getVirtualFolder(java.lang.String virtualFolderName)
                                        throws java.lang.Exception

Returns the VirtualFolderContainer associated with the entered name. If no such named VirtualFolderContainer exists, the method returns null.

Specified by:

getVirtualFolder in interface FCServerIfc

Parameters:

virtualFolderName - Name of a virtual folder that you would like

Returns:

VirtualFolderContainer with the given name, or null.

Throws:

java.lang.Exception

getVirtualFolders

public java.util.Collection<VirtualFolderContainer> getVirtualFolders()
                                                               throws java.lang.Exception

Returns the VirtualFolders. If no VirtualFolders exists, the method returns an empty collection.

Specified by:

getVirtualFolders in interface FCServerIfc

Returns:

Collection of VirtualFolders.

Throws:

java.lang.Exception

modifyVirtualFolder

public void modifyVirtualFolder(VirtualFolderContainer folder)
                         throws java.lang.Exception

Modifies the virtual folder with with with the given name. Note that modification of the VirtualFolder name is not permitted in FileCatalyst Server. The label (which is the value presented to the end user as a sub-directory) may be changed, as well as the description and the physical path the folder maps to.

Specified by:

modifyVirtualFolder in interface FCServerIfc

Parameters:

folder - Virtual folder that you would like to modify

Throws:

java.lang.Exception

deleteVirtualFolder

public void deleteVirtualFolder(java.lang.String virtualFolderName)
                         throws java.lang.Exception

Deletes the VirtualFolderContainer with the given name. all relationships associated with this VirtualFolderContainer will be deleted.

Specified by:

deleteVirtualFolder in interface FCServerIfc

Parameters:

virtualFolderName - Name of virtual folder that you would like to delete

Throws:

java.lang.Exception

linkUserAndFolder

public void linkUserAndFolder(java.lang.String userName,
                              java.lang.String virtualFolderName,
                              PermissionsContainer permission)
                       throws java.lang.Exception

Links a user to a virtual folder with given permissions

Specified by:

linkUserAndFolder in interface FCServerIfc

Parameters:

userName - Name of user you would like to link

virtualFolderName - Name of virtual folder that you would like to link

permission - Permission settings that you would like to use for the link

Throws:

java.lang.Exception

unlinkUserAndFolder

public void unlinkUserAndFolder(java.lang.String userName,
                                java.lang.String virtualFolderName)
                         throws java.lang.Exception

Unlinks a user to a virtual folder.

Specified by:

unlinkUserAndFolder in interface FCServerIfc

Parameters:

userName - Name of user you would like to unlink

virtualFolderName - Name of virtual folder that you would like to unlink

Throws:

java.lang.Exception

getFoldersLinkedToUser

public java.util.Collection<FolderUserCanAccess> getFoldersLinkedToUser(java.lang.String userName)
                                                                 throws java.lang.Exception

Returns a list view of links connecting a folder to a user. Each entry contains a specific folder the user has access to, and includes all access points generated by granting permission directly to the user and the list of groups which a user has access to. Maximum permissions granted to the user is also specified.

Specified by:

getFoldersLinkedToUser in interface FCServerIfc

Parameters:

userName - Name of the user that you would like the folders for

Returns:

Collection

Throws:

java.lang.Exception

getUsersLinkedToFolder

public java.util.Collection<ResourceGrantedToFolder> getUsersLinkedToFolder(java.lang.String virtualFolderName)
                                                                     throws java.lang.Exception

Return a list of users linked to a folder

Specified by:

getUsersLinkedToFolder in interface FCServerIfc

Parameters:

virtualFolderName - Name of the virtual folder that you would like all the users for

Returns:

Collection

Throws:

java.lang.Exception

getPermissionsForUserAndFolder

public PermissionsContainer getPermissionsForUserAndFolder(java.lang.String userName,
                                                           java.lang.String virtualFolderName)
                                                    throws java.lang.Exception

Permission list that a user has regarding a folder.

Specified by:

getPermissionsForUserAndFolder in interface FCServerIfc

Parameters:

userName - User that you would like to get permissions for

virtualFolderName - Virtual Folder that you would like to get permissions for

Returns:

PermissionsContainer, null if no link exists between user and folder

Throws:

java.lang.Exception

linkGroupAndFolder

public void linkGroupAndFolder(java.lang.String groupname,
                               java.lang.String foldername,
                               PermissionsContainer permission)
                        throws java.lang.Exception

Create access for a group to a virtual folder with a specified permission set.

Specified by:

linkGroupAndFolder in interface FCServerIfc

Parameters:

groupname - Name of the group

foldername - Folder name (not label), used as PK in the database

permission - Permission container.

Throws:

java.lang.Exception - Throws exception if group or folder does not exist in FileCatalyst Server

unlinkGroupAndFolder

public void unlinkGroupAndFolder(java.lang.String groupname,
                                 java.lang.String foldername)
                          throws java.lang.Exception

Remove access of a group to a virtual folder.

Specified by:

unlinkGroupAndFolder in interface FCServerIfc

Parameters:

groupname - Name of the group

foldername - Folder name (not label), used as PK in the database

Throws:

java.lang.Exception - Throws exception if group or folder does not exist in FileCatalyst Server

getFoldersLinkedToGroup

public java.util.Collection<FolderGroupCanAccess> getFoldersLinkedToGroup(java.lang.String groupname)
                                                                   throws java.lang.Exception

Return a list view of folders that is linked to a group along with their permissions Each entry contains a specific folder the folder has access to, and includes permissions granted to the group.

Specified by:

getFoldersLinkedToGroup in interface FCServerIfc

Parameters:

groupname - Name of the group to query against

Returns:

List of folders a group has access to.

Throws:

java.lang.Exception

getGroupsLinkedToFolder

public java.util.Collection<ResourceGrantedToFolder> getGroupsLinkedToFolder(java.lang.String virtualFolderName)
                                                                      throws java.lang.Exception

Return a list of groups that is linked to a folder along with their permissions. Note: Users connected to the folder is not

Specified by:

getGroupsLinkedToFolder in interface FCServerIfc

Parameters:

virtualFolderName - Unique name (PK) of the virtual folder used to identify object in database.

Returns:

List of groups who have access to a folder.

Throws:

java.lang.Exception

getPermissionsForGroupAndFolder

public PermissionsContainer getPermissionsForGroupAndFolder(java.lang.String groupname,
                                                            java.lang.String foldername)
                                                     throws java.lang.Exception

Return a permission container that describes the relationship between the group and folder.

Specified by:

getPermissionsForGroupAndFolder in interface FCServerIfc

Parameters:

groupname - Name of the group that you like the permissions for

foldername - Folder that you would like the permissions for

Returns:

Permission container, null if no link exists between group and folder.

Throws:

java.lang.Exception

setStatusClientDisabled

public void setStatusClientDisabled(boolean newVal)

for testing.

Specified by:

setStatusClientDisabled in interface FCServerIfcExtended

Parameters:

newVal -

killSessionByUserId

public void killSessionByUserId(java.lang.String username)
                         throws java.lang.Exception,
                                java.lang.IllegalStateException

Kill specific users connected to the system

Specified by:

killSessionByUserId in interface FCServerIfc

Parameters:

username - Username on the FileCatalyst Direct Server

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

java.lang.IllegalStateException - thrown if status client was explictly disabled.

killAllSessions

public void killAllSessions()
                     throws java.lang.Exception,
                            java.lang.IllegalStateException

Kill all connected user sessions on the system

Specified by:

killAllSessions in interface FCServerIfc

Throws:

java.lang.IllegalStateException - thrown if status client was explictly disabled.

java.lang.Exception - thrown if you cannot connect to a remote admin.

getClientSessions

public java.util.LinkedList<ClientSessionContainer> getClientSessions()
                                                               throws java.lang.Exception,
                                                                      java.lang.IllegalStateException

Gets the list of sessions currently running on FileCatalyst Server. Must have StatusClient enabled for this call to work, as this is where the information is stored. When used via command-line call, output looks like the following: START SESSION LIST: sessionID | userName | remoteIP | status | fileName | fileSize | bytesSoFar | elapsedTime | clientType | transmitRateKbps | receiveRateKbps | connectedTimeSec | isTransferring | overrideBandwidth | overridePriority | deliveryTime 1340742540245-129-1339785388230|a|192.168.1.169|27% - Receiving (UDP)...|E:\TESTDATA\FC user data\4GigFilewData0.tst|4294967296|1192510388|201099|FileCatalyst HotFolder v3.0.1|0|48730|229|true|0|0|0 1340742540728-130-1339785388230|b|192.168.1.169|14% - Sending (UDP)...|E:\TESTDATA\FC user data\b\4GigFilewData0.tst|4294967296|627985642|105079|FileCatalyst HotFolder v3.0.1|48693|0|228|true|2000|0|0 END SESSION LIST

Specified by:

getClientSessions in interface FCServerIfc

Returns:

LinkedList of sessions currently running on the FileCatalyst Server

Throws:

java.lang.Exception - Thrown if you cannot connect to the FCServer admin service.

java.lang.IllegalStateException - Thrown if status client is explicitly disabled in FCServerAPI.

setOverridePriority

public void setOverridePriority(java.lang.String sessionID,
                                int priority)
                         throws InvalidArgumentException,
                                java.lang.Exception

Sets an override priority for a given client session.

Specified by:

setOverridePriority in interface FCServerIfc

Parameters:

priority - int value for priority: 1=low, 10=high, 0=no override (default)

Throws:

InvalidArgumentException - Priority value passed in is incorrect (legal values: 0, 1-10)

java.lang.Exception - Cannot connect to the remote server

setDeliveryTime

public void setDeliveryTime(java.lang.String sessionID,
                            long deliveryTime)
                     throws InvalidArgumentException,
                            java.lang.Exception

Sets a delivery time for a given client session.

Parameters:

sessionID - ID of the session that you wish to override

deliveryTime - long value for expected delivery time.

Throws:

InvalidArgumentException - BandwidthKbps value passed in is incorrect (legal values: >= 0)

java.lang.Exception - Cannot connect to the remote server

setOverrideBandwidth

public void setOverrideBandwidth(java.lang.String sessionID,
                                 int bandwidthKbps)
                          throws InvalidArgumentException,
                                 java.lang.Exception

Sets an override bandwidth for a given client session.

Specified by:

setOverrideBandwidth in interface FCServerIfc

Parameters:

sessionID - ID of the session that you wish to override

bandwidthKbps - int value for override bandwidth.

Throws:

InvalidArgumentException - BandwidthKbps value passed in is incorrect (legal values: >= 0)

java.lang.Exception - Cannot connect to the remote server

resetAllOverrides

public void resetAllOverrides()
                       throws java.lang.Exception

Resets all bandwidth/priority overrides back to default values.

Specified by:

resetAllOverrides in interface FCServerIfc

Throws:

java.lang.Exception - Cannot connect to the remote server

killSessionBySessionId

public void killSessionBySessionId(java.lang.String sessionID)
                            throws java.lang.Exception,
                                   java.lang.IllegalStateException

Kill specific session connected to the system

Specified by:

killSessionBySessionId in interface FCServerIfc

Parameters:

sessionID - String SessionID on the FileCatalyst Direct Server

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

java.lang.IllegalStateException - thrown if status client was explictly disabled.

getTransmitRateKbps

public int getTransmitRateKbps()
                        throws java.lang.Exception,
                               java.lang.IllegalStateException

Shows kbps rates (transmit) of the server

Specified by:

getTransmitRateKbps in interface FCServerIfc

Returns:

Transmit rate in kbps

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

java.lang.IllegalStateException - thrown if status client was explicitly disabled.

getReceiveRateKbps

public int getReceiveRateKbps()
                       throws java.lang.Exception,
                              java.lang.IllegalStateException

Shows kbps rates (receive) of the server

Specified by:

getReceiveRateKbps in interface FCServerIfc

Returns:

Receive rate in kbps

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

java.lang.IllegalStateException - thrown if status client was explictly disabled.

getTotalRateKbps

public int getTotalRateKbps()
                     throws java.lang.Exception,
                            java.lang.IllegalStateException

Shows kbps rates (total) of the server

Specified by:

getTotalRateKbps in interface FCServerIfc

Returns:

Total rate in kbps

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

java.lang.IllegalStateException - thrown if status client was explictly disabled.

getRequestString

public java.lang.String getRequestString()

Returns the server request string

Specified by:

getRequestString in interface FCServerIfc

Returns:

String

getLicenseString

public java.lang.String getLicenseString()

Returns the server license string

Specified by:

getLicenseString in interface FCServerIfc

Returns:

String

setLicenseString

public void setLicenseString(java.lang.String newLicense)
                      throws java.lang.Exception

Sets the server license key

Specified by:

setLicenseString in interface FCServerIfc

Parameters:

newLicense - String representing the new license

Throws:

java.lang.Exception

getConfigSource

public unlimited.fc.com.ConfigSourceIfc<unlimited.fc.server.FileCatalystServerInterface> getConfigSource()

Method used for testing and integration with JUnit. PACKAGE FRIENDLY -- Should be used only by testing packages (test.unlimited.fc.server.api.*)

Specified by:

getConfigSource in interface FCServerIfc

Returns:

The config source

isStatusClientDisabled

public boolean isStatusClientDisabled()

Returns whether or not the status client is disabled

Specified by:

isStatusClientDisabled in interface FCServerIfc

Returns:

the statusClientDisabled

getUsers

public java.util.Collection<unlimited.fc.entity.user.User> getUsers()
                                                             throws java.lang.Exception

Returns the current users on the server

Returns:

A collection containing all of the users on the server

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

getAllUsers

public java.util.Collection<UserContainer> getAllUsers()
                                                throws java.lang.Exception

Specified by:

getAllUsers in interface FCServerIfc

Throws:

java.lang.Exception

getUserCount

public int getUserCount()
                 throws java.lang.Exception

Returns the current amount of users that are on the system

Specified by:

getUserCount in interface FCServerIfc

Returns:

Returns an integer of how many users are on the server

Throws:

java.lang.Exception - thrown if you cannot connect to a remote admin.

getDefaultIdleTime

public int getDefaultIdleTime()

Returns the default time

Specified by:

getDefaultIdleTime in interface FCServerIfc

Returns:

The default idle time

setDefaultIdleTime

public void setDefaultIdleTime(int idleTime)

Sets the default idle time to whatever value is specified

Specified by:

setDefaultIdleTime in interface FCServerIfc

Parameters:

idleTime - New default idle time to use

addTempUser

public void addTempUser(java.lang.String newusername,
                        java.lang.String newuserpass)
                 throws java.lang.Exception

Adds a temporary FC web user to the system. This user has all of the benefits of a normal user, however it will also remove itself from the server when it remains idle for a certain amount of time

Specified by:

addTempUser in interface FCServerIfc

Parameters:

newusername - Name of the user to be created

newuserpass - Password for the user to be created

Throws:

java.lang.Exception

addTempUser

public void addTempUser(java.lang.String newusername,
                        java.lang.String newuserpass,
                        java.lang.String newhomedir)
                 throws java.lang.Exception

Adds a temporary FC web user to the system. This user has all of the benefits of a normal user, however it will also remove itself from the server when it remains idle for a certain amount of time

Specified by:

addTempUser in interface FCServerIfc

Parameters:

newusername - Name of the user to be created

newuserpass - Password for the user to be created

newhomedir - Home directory of the user to be created

Throws:

java.lang.Exception

addTempUser

@Deprecated
public void addTempUser(java.lang.String newusername,
                                     java.lang.String newuserpass,
                                     java.lang.String newhomedir,
                                     int userType)
                              throws java.lang.Exception

Deprecated. Adds a temporary user to the system. No setting of any userType will be respected by this method, userType will always default to a temporary FC web user that has remote directory browsing privileges. Method has been solely kept for legacy reasons.

Specified by:

addTempUser in interface FCServerIfc

Parameters:

newusername - Name of the user to be created

newuserpass - Password for the user to be created

newhomedir - Home directory of the user to be created

userType - Ignored. Value always default to TEMPORARY_FC_WEB_USER (3)

Throws:

java.lang.Exception