|
Copyright © 2000, 2009, Oracle and/or its affiliates. All rights reserved. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@ControlInterface public interface CommunityContextControl
Control for contextual Community functionality-- functionality pertaining to the currently authenticated user and the currently viewed community. Because users may not be allowed to view disabled communities or view communities if their membership is not active, some operations are not possible to expose through this control as it only pertains to the currently viewed community and currently authenticated user.
CommunityManagerControl
,
CommunityMemberControl
,
CommunityInvitationControl
,
CommunityContext
,
CommunityUserContext
Method Summary | |
---|---|
void |
activateMember(ResourceContext context)
Activates the CommunityMember associated with the currently authenticated user
globally for all Communities. |
void |
addMembershipCapability(MembershipCapability capability,
ResourceContext context)
Adds a capability to the CommunityMembership
associated with the currently viewed desktop and authenticated user. |
CommunityMember |
createMember(boolean active,
boolean external,
ResourceContext context)
Creates a new CommunityMember for the currently authenticated user. |
void |
deactivateCommunity(ResourceContext context)
Sets the state of the community associated with the currently viewed desktop to INACTIVE. |
void |
disableMember(ResourceContext context)
Disables the CommunityMember associated with the currently authenticated user
globally for all Communities. |
void |
disableMembership(ResourceContext context)
Disables the CommunityMembership associated with the currently
viewed desktop and authenticated user. |
void |
disablePersonalPages(ResourceContext context)
Disables members from adding personal pages to the community associated with the currently viewed desktop. |
void |
enablePersonalPages(ResourceContext context)
Enables members to add personal pages to the community associated with the currently viewed desktop. |
CommunityDefinition |
getCommunity(ResourceContext context)
Retrieves the CommunityDefinition for the community currently being viewed,
or null if no community is currently being viewed. |
CommunityContext |
getCommunityContext(CommunityDefinitionId communityId,
ResourceContext context)
Returns the CommunityContext object associated with the specified
CommunityDefinitionId . |
CommunityContext |
getCommunityContext(CommunityURI communityUri,
ResourceContext context)
Returns the CommunityContext object associated with the specified community. |
CommunityContext |
getCommunityContext(ResourceContext context)
Retrieves the "default" CommunityContext object if it is appropriate. |
GenericURL |
getCommunityURL(javax.servlet.http.HttpServletResponse response,
CommunityURI community,
ResourceContext context)
Returns a URL to the specified community, if the URL can be determined. |
CommunityMember |
getMember(ResourceContext context)
Retrieves the CommunityMember object populated with information for the
community member currently logged in. |
SortableFilterablePagedResult<CommunityMembership> |
getMemberCommunityMemberships(MemberMembershipCriteria criteria,
int pageSize,
ResourceContext context)
Returns a paginated set of all CommunityMembership objects for a specified
user or the currently authenticated user that meet the specified criteria. |
MemberMembershipCriteria |
getMemberMembershipCriteria(ResourceContext context)
Returns a MemberMembershipCriteria object for the currently authenticated user. |
CommunityMembership |
getMembership(ResourceContext context)
Retrieves the CommunityMembership object assicated with this
CommunityContext object, if a membership exists. |
boolean |
isMembershipActive(ResourceContext context)
Determines if the member and membership records associated with the authenticated principal (logged-in user) and the currently-viewed community are active or disabled. |
void |
removeMember(ResourceContext context)
Removes the CommunityMember associated with the currently authenticated user
globally for all Communities. |
void |
removeMembership(ResourceContext context)
Destroys the CommunityMembership associated with the
currently viewed desktop and authenticated user. |
void |
removeMembershipCapability(MembershipCapability capability,
ResourceContext context)
Removes a capability from the CommunityMembership
associated with the currently viewed desktop and authenticated user. |
void |
setCommunityExpirationDate(Date expirationDate,
ResourceContext context)
Sets the expiration date for the community associated with the currently viewed desktop. |
CommunityDefinition |
updateCommunity(CommunityDefinition communityDefinition,
boolean invokeCallbackClass,
ResourceContext context)
Updates the CommunityDefinition for the community associated with the currently
viewed desktop. |
CommunityDefinition |
updateCommunity(CommunityDefinition communityDefinition,
ResourceContext context)
Deprecated This method does not invoke CommunityCallback classes registered with the community if the community is activated or deactivated through this call. Use updateCommunity(com.bea.netuix.application.definition.CommunityDefinition, boolean, ResourceContext)
instead. |
long |
updateLastAccessDate(ResourceContext context)
Updates the last access date for the membership associated with the currently viewed desktop and authenticated user. |
Method Detail |
---|
void activateMember(ResourceContext context) throws ObjectNotFoundException, ToolsException
CommunityMember
associated with the currently authenticated user
globally for all Communities.
context
- the resource context
ObjectNotFoundException
- if no member record exists for the
currently-logged-in user or if no user is currently logged in.
ToolsException
CommunityMember createMember(boolean active, boolean external, ResourceContext context) throws ToolsException, DuplicateObjectException, NotEntitledException
CommunityMember
for the currently authenticated user.
active
- true
if the CommunityMember
should be
created with active status.external
- the external
flag for the new CommunityMember
,
which may be useful for tracking purposes in some
situations but is not used in the framework.context
- the resource context
CommunityMember
object
DuplicateObjectException
- if a CommunityMember
already exists
for the currently-logged-in user.
NotEntitledException
- if no user is currently logged in.
ToolsException
void disableMember(ResourceContext context) throws ObjectNotFoundException, ToolsException
CommunityMember
associated with the currently authenticated user
globally for all Communities.
context
- the resource context
ObjectNotFoundException
- if no member record exists for the
currently-logged-in user or if no user is currently logged in.
ToolsException
CommunityMember getMember(ResourceContext context)
CommunityMember
object populated with information for the
community member currently logged in. If there is no WLS user currently
logged in, or if the user is not a community member, null is returned.
context
- the resource context
CommunityMember
object for the currently-logged-in WLS user,
or null if the user is not a community member or if no user is logged in.MemberMembershipCriteria getMemberMembershipCriteria(ResourceContext context) throws NotEntitledException
getMemberCommunityMemberships()
method.
context
- the resource context
NotEntitledException
- if no user is logged in.MemberMembershipCriteria
SortableFilterablePagedResult<CommunityMembership> getMemberCommunityMemberships(MemberMembershipCriteria criteria, int pageSize, ResourceContext context) throws ToolsException, NotEntitledException
CommunityMembership
objects for a specified
user or the currently authenticated user that meet the specified criteria.
If the returned SortableFilterablePagedResult is re-filtered using the reFilter()
method, the filter specified is used in addition to the original filter criteria
specified in the MemberMembershipCriteria object. If the filter criteria
specified in the reFilter() method conflicts with a criteria specified in the original
MemberMembershipCriteria object, the newly specified filter criteria is used in
place of the original MemberMembershipCriteria for that field only; all other
field criteria specified in the MemberMembershipCriteria object will still be
used as filter criteria.
criteria
- the criteria CommunityMemberships must match to be returned.
If null
, a MemberMembershipCriteria object is created
specifying the currently authenticated user. Also see the
getMemberMembershipCriteria()
method to get a
MemberMembershipCriteria object for the currently authenticated user.pageSize
- the number of membership objects to return per result page.context
- the resource context
ToolsException
NotEntitledException
- if no user is logged in.MemberMembershipCriteria
void removeMember(ResourceContext context) throws ObjectNotFoundException, ToolsException
CommunityMember
associated with the currently authenticated user
globally for all Communities.
context
- the resource context
ObjectNotFoundException
- if no member record exists for the
currently-logged-in user or if no user is currently logged in.
ToolsException
CommunityContext getCommunityContext(ResourceContext context)
CommunityContext
object if it is appropriate.
This is the CommunityContext
appropriate for the Desktop
viewed by the Request associated with this CommunityUserContext
.
context
- the resource context
CommunityContext
object associated with the request, or null
if the desktop
associated with the request is not a community desktop.CommunityContext getCommunityContext(CommunityURI communityUri, ResourceContext context)
CommunityContext
object associated with the specified community.
communityUri
- the URI for the community.context
- the resource context
CommunityContext
object, or null if no
community with the specified URI exists.
CommunityContext getCommunityContext(CommunityDefinitionId communityId, ResourceContext context)
CommunityContext
object associated with the specified
CommunityDefinitionId
.
communityId
- the community ID.context
- the resource context
CommunityContext
object.GenericURL getCommunityURL(javax.servlet.http.HttpServletResponse response, CommunityURI community, ResourceContext context)
null
will be returned.
response
- the response object.community
- the community to get a URL to.context
- the resource context
null
will be returned.boolean isMembershipActive(ResourceContext context) throws IllegalStateException
context
- the resource context
true
if both the CommunityMember
and CommunityMembership
associated with the currently authenticated user and viewed community are active;
false
if the member
or membership record does not exist or are disabled.
IllegalStateException
- if the currently-viewed desktop is not a community.CommunityDefinition getCommunity(ResourceContext context)
CommunityDefinition
for the community currently being viewed,
or null
if no community is currently being viewed.
context
- the resource context
CommunityDefinition
object for the community associated with this
request, or null
if no community is associated with the request.CommunityMembership getMembership(ResourceContext context)
CommunityMembership
object assicated with this
CommunityContext
object, if a membership exists.
context
- the resource context
CommunityMembership
object for the currently-logged-in user
for the community associated with this CommunityContext
object,
or null if no such membership exists or if the currently viewed desktop is
not a community.CommunityDefinition updateCommunity(CommunityDefinition communityDefinition, ResourceContext context) throws ObjectNotFoundException, NotEntitledException, IllegalOperationException, ObjectInUseException, ToolsException, IllegalStateException
updateCommunity(com.bea.netuix.application.definition.CommunityDefinition, boolean, ResourceContext)
instead.
CommunityDefinition
for the community associated with the currently
viewed desktop.
communityDefinition
- community definition with updated
attributescontext
- the resource context
CommunityDefinition
ObjectNotFoundException
- if community to be updated does not exist
NotEntitledException
- if current user does not have permission
to update this community
IllegalOperationException
- if part of or all of the update is illegal
based on the current state of the community
for e.g. if the update tries to set expirationDate on
or activate a community that is marked as
a template
ObjectInUseException
- if the update tries to point the community
to a desktop that is already in use by another
community
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.CommunityDefinition updateCommunity(CommunityDefinition communityDefinition, boolean invokeCallbackClass, ResourceContext context) throws ObjectNotFoundException, NotEntitledException, IllegalOperationException, ObjectInUseException, ToolsException, IllegalStateException, CommunityCallbackException
CommunityDefinition
for the community associated with the currently
viewed desktop.
communityDefinition
- community definition with updated
attributesinvokeCallbackClass
- if true
and the community is activated
or deactivated by this call, invokes the appropriate
methods on the CommunityCallback object associated
with the community, if one exists. If false
,
no callback call is made.context
- the resource context
CommunityDefinition
ObjectNotFoundException
- if community to be updated does not exist
NotEntitledException
- if current user does not have permission
to update this community
IllegalOperationException
- if part of or all of the update is illegal
based on the current state of the community
for e.g. if the update tries to set expirationDate on
or activate a community that is marked as
a template
ObjectInUseException
- if the update tries to point the community
to a desktop that is already in use by another
community
CommunityCallbackException
- if an error occurs when making a
community callback
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.void deactivateCommunity(ResourceContext context) throws IllegalArgumentException, ObjectNotFoundException, NotEntitledException, CommunityCallbackException, ToolsException, IllegalStateException
context
- the resource context
ObjectNotFoundException
- if community to be deactivated does not
exist
NotEntitledException
- if current user does not have permission
to deactivate this community
CommunityCallbackException
- if an error occurs when making a
community callback
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.
IllegalArgumentException
void setCommunityExpirationDate(Date expirationDate, ResourceContext context) throws IllegalArgumentException, ObjectNotFoundException, NotEntitledException, IllegalOperationException, ToolsException, IllegalStateException
expirationDate
- The new expiration date.context
- the resource context
IllegalArgumentException
- If the expirationDate
is before current
date
ObjectNotFoundException
- if specified community does not exist
NotEntitledException
- if current user does not have permission
to set the expirationDate for this community
IllegalOperationException
- if this community is a template
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.void enablePersonalPages(ResourceContext context) throws ObjectNotFoundException, NotEntitledException, ToolsException, IllegalStateException
context
- the resource context
ObjectNotFoundException
- if specified community does not exist
NotEntitledException
- if current user does not have permission
to perform this operation
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.void disablePersonalPages(ResourceContext context) throws ObjectNotFoundException, NotEntitledException, ToolsException, IllegalStateException
context
- the resource context
ObjectNotFoundException
- if specified community does not exist
NotEntitledException
- if current user does not have permission
to perform this operation
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.void removeMembership(ResourceContext context) throws ToolsException, ObjectNotFoundException, IllegalStateException
CommunityMembership
associated with the
currently viewed desktop and authenticated user.
context
- the resource context
ToolsException
ObjectNotFoundException
- if there is no CommunityMembership
associated
with this community for the authenticated user.
IllegalStateException
- if the currently-viewed desktop is not a community.void disableMembership(ResourceContext context) throws ToolsException, ObjectNotFoundException, IllegalStateException
CommunityMembership
associated with the currently
viewed desktop and authenticated user.
context
- the resource context
ToolsException
ObjectNotFoundException
- if no membership exists for the currently authenticated
user for this community.
IllegalStateException
- if the currently-viewed desktop is not a community.long updateLastAccessDate(ResourceContext context) throws ObjectNotFoundException, ToolsException, IllegalStateException
context
- the resource context
ObjectNotFoundException
- if no membership is associated with the
currently authenticated user.
ToolsException
IllegalStateException
- if the currently-viewed desktop is not a community.void addMembershipCapability(MembershipCapability capability, ResourceContext context) throws ToolsException, ObjectNotFoundException, IllegalArgumentException, IllegalStateException
CommunityMembership
associated with the currently viewed desktop and authenticated user.
capability
- the capability to add to the membershipcontext
- the resource context
ToolsException
ObjectNotFoundException
- if there is no CommunityMembership
associated
with the authenticated user.
IllegalArgumentException
- if the capability specified is not valid.
IllegalStateException
- if the currently-viewed desktop is not a community.void removeMembershipCapability(MembershipCapability capability, ResourceContext context) throws ToolsException, ObjectNotFoundException, IllegalArgumentException, IllegalStateException
CommunityMembership
associated with the currently viewed desktop and authenticated user.
capability
- the capability to remove from the membershipcontext
- the resource context
ToolsException
ObjectNotFoundException
- if there is no CommunityMembership
associated
with the authenticated user.
IllegalArgumentException
- if the capability specified is not valid.
IllegalStateException
- if the currently-viewed desktop is not a community.
|
Copyright © 2000, 2009, Oracle and/or its affiliates. All rights reserved. | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |