Package org.odpi.openmetadata.accessservices.communityprofile.server.spring

Class CommunityResource

java.lang.Object
org.odpi.openmetadata.accessservices.communityprofile.server.spring.CommunityResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/access-services/community-profile/users/{userId}") public class CommunityResource extends Object
The CommunityResource provides a Spring based server-side REST API that supports the CommunityManagementInterface. It delegates each request to the CommunityRESTServices. This provides the server-side implementation of the Community Profile Open Metadata Assess Service (OMAS) which is used to manage information about people, roles and organizations.

  • Constructor Summary

    Constructors
    Constructor
    Description
    CommunityResource()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    clearCommunityRole(String serverName, String userId, String communityGUID, String communityRoleGUID, org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
    Remove a relationship between a community and a person role.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createCommunity(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.ReferenceableRequestBody requestBody)
    Create a new metadata element to represent a community.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createCommunityFromTemplate(String serverName, String userId, String templateGUID, org.odpi.openmetadata.accessservices.communityprofile.rest.TemplateRequestBody requestBody)
    Create a new metadata element to represent a community using an existing metadata element as a template.
    org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse
    findCommunities(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of community metadata elements that contain the search string.
    org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse
    getCommunitiesByName(String serverName, String userId, int startFrom, int pageSize)
    Retrieve the list of community metadata elements.
    org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse
    getCommunitiesByName(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of community metadata elements with a matching qualified or display name.
    org.odpi.openmetadata.commonservices.ffdc.rest.CommunityResponse
    getCommunityByGUID(String serverName, String userId, String guid)
    Retrieve the community metadata element with the supplied unique identifier.
    org.odpi.openmetadata.commonservices.ffdc.rest.PersonRolesResponse
    getRolesForCommunity(String serverName, String userId, String communityGUID, int startFrom, int pageSize)
    Return information about a person role connected to the named community.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeCommunity(String serverName, String userId, String communityGUID, org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
    Remove the metadata element representing a community.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    setupCommunityRole(String serverName, String userId, String communityGUID, String communityRoleGUID, org.odpi.openmetadata.commonservices.ffdc.rest.RelationshipRequestBody requestBody)
    Create a relationship between a community and a person role.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateCommunity(String serverName, String userId, String communityGUID, boolean isMergeUpdate, org.odpi.openmetadata.commonservices.ffdc.rest.ReferenceableRequestBody requestBody)
    Update the metadata element representing a community.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • CommunityResource

      public CommunityResource()
      Default constructor

  • Method Details

    • createCommunity

      @PostMapping(path="/communities") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createCommunity(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.ReferenceableRequestBody requestBody)
      Create a new metadata element to represent a community.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - properties to store
      Returns:
      unique identifier of the new metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • createCommunityFromTemplate

      @PostMapping(path="/communities/from-template/{templateGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createCommunityFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @RequestBody org.odpi.openmetadata.accessservices.communityprofile.rest.TemplateRequestBody requestBody)
      Create a new metadata element to represent a community using an existing metadata element as a template.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      templateGUID - unique identifier of the metadata element to copy
      requestBody - properties that override the template
      Returns:
      unique identifier of the new metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • updateCommunity

      @PostMapping(path="/communities/{communityGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateCommunity(@PathVariable String serverName, @PathVariable String userId, @PathVariable String communityGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.ReferenceableRequestBody requestBody)
      Update the metadata element representing a community.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      communityGUID - unique identifier of the metadata element to update
      isMergeUpdate - should the new properties be merged with the existing properties of overlay them?
      requestBody - new properties for this element
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • setupCommunityRole

      @PostMapping(path="/communities/{communityGUID}/community-roles/{communityRoleGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse setupCommunityRole(@PathVariable String serverName, @PathVariable String userId, @PathVariable String communityGUID, @PathVariable String communityRoleGUID, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.RelationshipRequestBody requestBody)
      Create a relationship between a community and a person role.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      communityGUID - unique identifier of the community in the external data manager
      communityRoleGUID - unique identifier of the person role in the external data manager
      requestBody - data manager identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • clearCommunityRole

      @PostMapping(path="/communities/{communityGUID}/community-roles/{communityRoleGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse clearCommunityRole(@PathVariable String serverName, @PathVariable String userId, @PathVariable String communityGUID, @PathVariable String communityRoleGUID, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
      Remove a relationship between a community and a person role.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      communityGUID - unique identifier of the community in the external data manager
      communityRoleGUID - unique identifier of the person role in the external data manager
      requestBody - data manager identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • removeCommunity

      @PostMapping(path="/communities/{communityGUID}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeCommunity(@PathVariable String serverName, @PathVariable String userId, @PathVariable String communityGUID, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.ExternalSourceRequestBody requestBody)
      Remove the metadata element representing a community.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      communityGUID - unique identifier of the metadata element to remove
      requestBody - external source identifiers
      Returns:
      void or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • findCommunities

      @PostMapping(path="/communities/by-search-string") public org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse findCommunities(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of community metadata elements that contain the search string. The search string is treated as a regular expression.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - string to find in the properties
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getCommunitiesByName

      @PostMapping(path="/communities/by-name") public org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse getCommunitiesByName(@PathVariable String serverName, @PathVariable String userId, @RequestBody org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of community metadata elements with a matching qualified or display name. There are no wildcards supported on this request.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      requestBody - name to search for
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getRolesForCommunity

      @GetMapping(path="/person-roles/by-community/{communityGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.PersonRolesResponse getRolesForCommunity(@PathVariable String serverName, @PathVariable String userId, @PathVariable String communityGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return information about a person role connected to the named community.
      Parameters:
      serverName - called server
      userId - calling user
      communityGUID - unique identifier for the community
      startFrom - index of the list to start from (0 for start)
      pageSize - maximum number of elements to return.
      Returns:
      list of matching person roles InvalidParameterException name or userId is null PropertyServerException problem accessing property server UserNotAuthorizedException security access problem

    • getCommunitiesByName

      @GetMapping(path="/communities") public org.odpi.openmetadata.commonservices.ffdc.rest.CommunitiesResponse getCommunitiesByName(@PathVariable String serverName, @PathVariable String userId, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of community metadata elements.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of matching metadata elements or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)

    • getCommunityByGUID

      @GetMapping(path="/communities/{guid}") public org.odpi.openmetadata.commonservices.ffdc.rest.CommunityResponse getCommunityByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String guid)
      Retrieve the community metadata element with the supplied unique identifier.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      guid - unique identifier of the requested metadata element
      Returns:
      matching metadata element or InvalidParameterException one of the parameters is invalid or UserNotAuthorizedException the user is not authorized to issue this request or PropertyServerException there is a problem reported in the open metadata server(s)