com.atlassian.crowd.plugin.rest.service.controller

Class ApplicationController

java.lang.Object

com.atlassian.crowd.plugin.rest.service.controller.ApplicationController

public class ApplicationController
extends Object

Controller for the Application resource.

Since:

2.2

Constructor Summary

Constructors

Constructor and Description
ApplicationController(ApplicationManager applicationManager, DirectoryManager directoryManager, TrustedProxyManager trustedProxyManager, AliasManager aliasManager)

Method Summary

Methods

Modifier and Type	Method and Description
com.atlassian.plugins.rest.common.Link	addApplication(ApplicationEntity applicationEntity, URI baseUri) Adds a new application.
com.atlassian.plugins.rest.common.Link	addApplicationWithRequestAddress(ApplicationEntity applicationEntity, javax.servlet.http.HttpServletRequest request, URI baseUri) Adds a new application with the request address.
void	addRemoteAddress(long applicationId, RemoteAddressEntity remoteAddressEntity) Adds a remote address to the list of allowed addresses for the application.
void	deleteAlias(long applicationId, String username)
String	getAlias(long applicationId, String username)
Map<Long,String>	getAliasesForUser(String username)
ApplicationEntityList	getAllApplications(URI baseUri) Finds all applications.
ApplicationEntity	getApplicationById(long id, URI baseUri) Finds an application by ID.
ApplicationEntity	getApplicationByName(String name, URI baseUri) Finds an application by name.
Set<String>	getRequestAddresses(javax.servlet.http.HttpServletRequest request) Retrieves the list of request addresses.
String	getUsernameForAlias(long applicationId, String alias)
void	removeApplication(long applicationId) Removes an application.
void	removeRemoteAddress(long applicationId, String remoteAddress) Removes a remote address from the list of allowed addresses for the application.
void	setAlias(long applicationId, String username, String alias)
void	updateApplication(ApplicationEntity applicationEntity) Updates an existing application.

Methods inherited from class java.lang.Object

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

Constructor Detail

ApplicationController

public ApplicationController(ApplicationManager applicationManager,
                     DirectoryManager directoryManager,
                     TrustedProxyManager trustedProxyManager,
                     AliasManager aliasManager)

Method Detail

getApplicationByName

public ApplicationEntity getApplicationByName(String name,
                                     URI baseUri)
                                       throws ApplicationNotFoundException

Finds an application by name.

Parameters:

name - name of the application

baseUri - base URI of the REST service

Returns:

ApplicationEntity

Throws:

ApplicationNotFoundException - if the application could not be found

getApplicationById

public ApplicationEntity getApplicationById(long id,
                                   URI baseUri)
                                     throws ApplicationNotFoundException

Finds an application by ID.

Parameters:

id - ID of the application

baseUri - baseURI of the applications resource

Returns:

ApplicationEntity

Throws:

ApplicationNotFoundException - if the application could not be found

getAllApplications

public ApplicationEntityList getAllApplications(URI baseUri)
                                         throws ApplicationNotFoundException

Finds all applications.

Parameters:

baseUri - base URI of the REST service

Returns:

ApplicationEntity

Throws:

ApplicationNotFoundException - if the application could not be found

addApplicationWithRequestAddress

public com.atlassian.plugins.rest.common.Link addApplicationWithRequestAddress(ApplicationEntity applicationEntity,
                                                                      javax.servlet.http.HttpServletRequest request,
                                                                      URI baseUri)
                                                                        throws InvalidCredentialException,
                                                                               DirectoryNotFoundException

Adds a new application with the request address.

Parameters:

applicationEntity - new application to add

request - HTTP request

baseUri - base URI of the REST service

Returns:

link to the new application

Throws:

InvalidCredentialException - if the given credentials are not valid

DirectoryNotFoundException - if the directory being mapped could not be found

addApplication

public com.atlassian.plugins.rest.common.Link addApplication(ApplicationEntity applicationEntity,
                                                    URI baseUri)
                                                      throws InvalidCredentialException,
                                                             DirectoryNotFoundException

Adds a new application.

Parameters:

applicationEntity - new application to add

baseUri - base URI of the REST service

Returns:

link to the new application

Throws:

InvalidCredentialException - if the given credentials are not valid

DirectoryNotFoundException - if the directory being mapped could not be found

removeApplication

public void removeApplication(long applicationId)
                       throws ApplicationManagerException

Removes an application.

Parameters:

applicationId - ID of the application

Throws:

ApplicationManagerException - if the remove operation is not permitted on the given application

updateApplication

public void updateApplication(ApplicationEntity applicationEntity)
                       throws ApplicationNotFoundException,
                              ApplicationManagerException,
                              DirectoryNotFoundException

Updates an existing application.

Parameters:

applicationEntity - application entity with the new details

Throws:

ApplicationNotFoundException - if the application could not be found

ApplicationManagerException - if there was an error updating the application

DirectoryNotFoundException - if a directory referenced by a directory mapping could not be found

addRemoteAddress

public void addRemoteAddress(long applicationId,
                    RemoteAddressEntity remoteAddressEntity)
                      throws ApplicationNotFoundException

Adds a remote address to the list of allowed addresses for the application.

Parameters:

applicationId - ID of the application

remoteAddressEntity - remote address entity to add

Throws:

ApplicationNotFoundException - if the application could not be found

removeRemoteAddress

public void removeRemoteAddress(long applicationId,
                       String remoteAddress)
                         throws ApplicationNotFoundException

Removes a remote address from the list of allowed addresses for the application.

Parameters:

applicationId - ID of the application

remoteAddress - remote address to remove

Throws:

ApplicationNotFoundException - if the application could not be found

getRequestAddresses

public Set<String> getRequestAddresses(javax.servlet.http.HttpServletRequest request)

Retrieves the list of request addresses.

Parameters:

request - HTTP request

Returns:

list of request addresses

getAlias

public String getAlias(long applicationId,
              String username)
                throws ApplicationNotFoundException,
                       com.sun.jersey.api.NotFoundException

Throws:

ApplicationNotFoundException

com.sun.jersey.api.NotFoundException

setAlias

public void setAlias(long applicationId,
            String username,
            String alias)
              throws ApplicationNotFoundException,
                     AliasAlreadyInUseException

Throws:

ApplicationNotFoundException

AliasAlreadyInUseException

deleteAlias

public void deleteAlias(long applicationId,
               String username)
                 throws ApplicationNotFoundException,
                        AliasAlreadyInUseException

Throws:

ApplicationNotFoundException

AliasAlreadyInUseException

getUsernameForAlias

public String getUsernameForAlias(long applicationId,
                         String alias)
                           throws ApplicationNotFoundException

Throws:

ApplicationNotFoundException

getAliasesForUser

public Map<Long,String> getAliasesForUser(String username)