AccessControlService (DMX 5.0-SNAPSHOT API)

All Known Implementing Classes:

AccessControlPlugin
```
public interface AccessControlService
```

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ADMIN_INITIAL_PASSWORD`
`static String`	`ADMIN_USERNAME`
`static String`	`ADMINISTRATION_WORKSPACE_NAME`
`static SharingMode`	`ADMINISTRATION_WORKSPACE_SHARING_MODE`
`static String`	`ADMINISTRATION_WORKSPACE_URI`
`static String`	`DEFAULT_PRIVATE_WORKSPACE_NAME`
`static String`	`SYSTEM_WORKSPACE_NAME`
`static SharingMode`	`SYSTEM_WORKSPACE_SHARING_MODE`
`static String`	`SYSTEM_WORKSPACE_URI`

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`createMembership(String username, long workspaceId)`
`Topic`	`createUserAccount(Credentials cred)`
`Topic`	`createUsername(String username)` Creates a Username topic and a private workspace.
`Permissions`	`getAssociationPermissions(long assocId)`
`Collection<Association>`	`getAssociationsByCreator(String username)`
`Collection<Association>`	`getAssociationsByOwner(String username)`
`Set<String>`	`getAuthorizationMethods()`
`String`	`getCreator(long objectId)` Returns the creator of a topic or an association.
`String`	`getModifier(long objectId)` Returns the modifier of a topic or an association.
`Topic`	`getPrivateWorkspace()` Returns the private workspace of the logged in user.
`Permissions`	`getTopicPermissions(long topicId)`
`Collection<Topic>`	`getTopicsByCreator(String username)`
`Collection<Topic>`	`getTopicsByOwner(String username)`
`String`	`getUsername()` Returns the username of the logged in user.
`Topic`	`getUsernameTopic()` Returns the "Username" topic of the logged in user.
`Topic`	`getUsernameTopic(String username)` Returns the "Username" topic for the specified username.
`String`	`getWorkspaceOwner(long workspaceId)` Returns the owner of a workspace.
`boolean`	`isMember(String username, long workspaceId)` Checks if a user is a member of the given workspace.
`void`	`login()` Checks weather the credentials in the authorization string match an existing User Account, and if so, creates an HTTP session.
`void`	`logout()` Logs the user out.
`void`	`registerAuthorizationMethod(String name, AuthorizationMethod am)`
`void`	`setWorkspaceOwner(Topic workspace, String username)` Sets the owner of a workspace.
`void`	`unregisterAuthorizationMethod(String name)`

- Field Detail
  - ADMIN_USERNAME
```
static final String ADMIN_USERNAME
```
    See Also:
    
    Constant Field Values
  - ADMIN_INITIAL_PASSWORD
```
static final String ADMIN_INITIAL_PASSWORD
```
  - ADMINISTRATION_WORKSPACE_NAME
```
static final String ADMINISTRATION_WORKSPACE_NAME
```
    See Also:
    
    Constant Field Values
  - ADMINISTRATION_WORKSPACE_URI
```
static final String ADMINISTRATION_WORKSPACE_URI
```
    See Also:
    
    Constant Field Values
  - ADMINISTRATION_WORKSPACE_SHARING_MODE
```
static final SharingMode ADMINISTRATION_WORKSPACE_SHARING_MODE
```
  - SYSTEM_WORKSPACE_NAME
```
static final String SYSTEM_WORKSPACE_NAME
```
    See Also:
    
    Constant Field Values
  - SYSTEM_WORKSPACE_URI
```
static final String SYSTEM_WORKSPACE_URI
```
    See Also:
    
    Constant Field Values
  - SYSTEM_WORKSPACE_SHARING_MODE
```
static final SharingMode SYSTEM_WORKSPACE_SHARING_MODE
```
  - DEFAULT_PRIVATE_WORKSPACE_NAME
```
static final String DEFAULT_PRIVATE_WORKSPACE_NAME
```
    See Also:
    
    Constant Field Values
- Method Detail
  - login
```
void login()
```
    Checks weather the credentials in the authorization string match an existing User Account, and if so, creates an HTTP session. ### FIXDOC
    
    Parameters:
    
    authHeader - the authorization string containing the credentials. ### FIXDOC Formatted like a "Authorization" HTTP header value. That is, "Basic " appended by the Base64 encoded form of "{username}:{password}".
  - logout
```
void logout()
```
    Logs the user out. That is invalidating the session associated with the JSESSION ID cookie. For a "non-private" DM installation the response is 204 No Content. For a "private" DM installation the response is 401 Authorization Required. In this case the webclient is supposed to shutdown the DM GUI then. The webclient of a "private" DM installation must only be visible/usable when logged in.
  - getUsername
```
String getUsername()
```
    Returns the username of the logged in user.
    
    Returns:
    
    The username, or null if no user is logged in.
  - getUsernameTopic
```
Topic getUsernameTopic()
```
    Returns the "Username" topic of the logged in user.
    
    Returns:
    
    The "Username" topic (type dmx.accesscontrol.username), or null if no user is logged in.
  - getPrivateWorkspace
```
Topic getPrivateWorkspace()
```
    Returns the private workspace of the logged in user.
    Note: a user can have more than one private workspace. This method returns only the first one.
    
    Returns:
    
    IllegalStateException if no user is logged in.
    
    Throws:
    
    RuntimeException - if the logged in user has no private workspace.
  - createUserAccount
```
Topic createUserAccount(Credentials cred)
```
    Returns:
    
    The "Username" topic of the created user account.
  - createUsername
```
Topic createUsername(String username)
```
    Creates a Username topic and a private workspace.
    
    Returns:
    
    created "Username" topic.
  - getUsernameTopic
```
Topic getUsernameTopic(String username)
```
    Returns the "Username" topic for the specified username.
    
    Parameters:
    
    username - a username. Must not be null.
    
    Returns:
    
    The "Username" topic (type dmx.accesscontrol.username), or null if no such username exists.
  - getWorkspaceOwner
```
String getWorkspaceOwner(long workspaceId)
```
    Returns the owner of a workspace.
    
    Returns:
    
    The username of the owner, or null if no owner is set. ### TODO: should throw an exception instead of returning null
  - setWorkspaceOwner
```
void setWorkspaceOwner(Topic workspace,
                       String username)
```
    Sets the owner of a workspace. ### TODO: should take an ID instead a topic. ### Core service must be extended with a property setter.
  - createMembership
```
void createMembership(String username,
                      long workspaceId)
```
  - isMember
```
boolean isMember(String username,
                 long workspaceId)
```
    Checks if a user is a member of the given workspace.
    
    Parameters:
    
    username - the user. If null is passed, false is returned. If an unknown username is passed an exception is thrown.
    
    workspaceId - the workspace.
    
    Returns:
    
    true if the user is a member, false otherwise.
  - getTopicPermissions
```
Permissions getTopicPermissions(long topicId)
```
    Returns:
    
    A Permissions object with one entry: dmx.accesscontrol.operation.write.
  - getAssociationPermissions
```
Permissions getAssociationPermissions(long assocId)
```
    Returns:
    
    A Permissions object with one entry: dmx.accesscontrol.operation.write.
  - getCreator
```
String getCreator(long objectId)
```
    Returns the creator of a topic or an association.
    
    Returns:
    
    The username of the creator, or null if no creator is set.
  - getModifier
```
String getModifier(long objectId)
```
    Returns the modifier of a topic or an association.
    
    Returns:
    
    The username of the modifier, or null if no modifier is set.
  - getTopicsByCreator
```
Collection<Topic> getTopicsByCreator(String username)
```
  - getTopicsByOwner
```
Collection<Topic> getTopicsByOwner(String username)
```
  - getAssociationsByCreator
```
Collection<Association> getAssociationsByCreator(String username)
```
  - getAssociationsByOwner
```
Collection<Association> getAssociationsByOwner(String username)
```
  - registerAuthorizationMethod
```
void registerAuthorizationMethod(String name,
                                 AuthorizationMethod am)
```
  - unregisterAuthorizationMethod
```
void unregisterAuthorizationMethod(String name)
```
  - getAuthorizationMethods
```
Set<String> getAuthorizationMethods()
```

Interface AccessControlService

Field Summary

Method Summary

Field Detail

ADMIN_USERNAME

ADMIN_INITIAL_PASSWORD

ADMINISTRATION_WORKSPACE_NAME

ADMINISTRATION_WORKSPACE_URI

ADMINISTRATION_WORKSPACE_SHARING_MODE

SYSTEM_WORKSPACE_NAME

SYSTEM_WORKSPACE_URI

SYSTEM_WORKSPACE_SHARING_MODE

DEFAULT_PRIVATE_WORKSPACE_NAME

Method Detail

login

logout

getUsername

getUsernameTopic

getPrivateWorkspace

createUserAccount

createUsername

getUsernameTopic

getWorkspaceOwner

setWorkspaceOwner

createMembership

isMember

getTopicPermissions

getAssociationPermissions

getCreator

getModifier

getTopicsByCreator

getTopicsByOwner

getAssociationsByCreator

getAssociationsByOwner

registerAuthorizationMethod

unregisterAuthorizationMethod

getAuthorizationMethods