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

Class EventBrokerResource

java.lang.Object
org.odpi.openmetadata.accessservices.datamanager.server.spring.EventBrokerResource
@RestController @RequestMapping("/servers/{serverName}/open-metadata/access-services/data-manager/users/{userId}") public class EventBrokerResource extends Object
EventBrokerResource is the server-side implementation of the Data Manager OMAS's support for topics. It matches the EventBrokerClient.

  • Constructor Summary

    Constructors
    Constructor
    Description
    EventBrokerResource()
    Default constructor

  • Method Summary

    Modifier and Type
    Method
    Description
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createEventType(String serverName, String userId, String topicGUID, org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeRequestBody requestBody)
    Create a new metadata element to represent a event type.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createEventTypeFromTemplate(String serverName, String userId, String templateGUID, String topicGUID, org.odpi.openmetadata.accessservices.datamanager.rest.TemplateRequestBody requestBody)
    Create a new metadata element to represent a event type using an existing metadata element as a template.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createTopic(String serverName, String userId, boolean eventBrokerIsHome, org.odpi.openmetadata.accessservices.datamanager.rest.TopicRequestBody requestBody)
    Create a new metadata element to represent a topic.
    org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse
    createTopicFromTemplate(String serverName, String userId, String templateGUID, boolean eventBrokerIsHome, org.odpi.openmetadata.accessservices.datamanager.rest.TemplateRequestBody requestBody)
    Create a new metadata element to represent a topic using an existing metadata element as a template.
    org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse
    findEventTypes(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of event type metadata elements that contain the search string.
    org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse
    findTopics(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.SearchStringRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of topic metadata elements that contain the search string.
    org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeResponse
    getEventTypeByGUID(String serverName, String userId, String guid)
    Retrieve the event type metadata element with the supplied unique identifier.
    org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse
    getEventTypesByName(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of event type metadata elements with a matching qualified or display name.
    org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse
    getEventTypesForEventSet(String serverName, String userId, String eventSetGUID, int startFrom, int pageSize)
    Return the list of event types associated with a EventSet.
    org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse
    getEventTypesForTopic(String serverName, String userId, String topicGUID, int startFrom, int pageSize)
    Return the list of schemas associated with a topic.
    org.odpi.openmetadata.accessservices.datamanager.rest.TopicResponse
    getTopicByGUID(String serverName, String userId, String guid)
    Retrieve the topic metadata element with the supplied unique identifier.
    org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse
    getTopicsByName(String serverName, String userId, org.odpi.openmetadata.commonservices.ffdc.rest.NameRequestBody requestBody, int startFrom, int pageSize)
    Retrieve the list of topic metadata elements with a matching qualified or display name.
    org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse
    getTopicsForEventBroker(String serverName, String userId, String eventBrokerGUID, String eventBrokerName, int startFrom, int pageSize)
    Retrieve the list of topics created by this topic manager.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    publishTopic(String serverName, String userId, String topicGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody nullRequestBody)
    Update the zones for the topic asset so that it becomes visible to consumers.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeEventType(String serverName, String userId, String eventTypeGUID, String qualifiedName, org.odpi.openmetadata.accessservices.datamanager.rest.MetadataSourceRequestBody requestBody)
    Remove the metadata element representing a event type.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    removeTopic(String serverName, String userId, String topicGUID, String qualifiedName, org.odpi.openmetadata.accessservices.datamanager.rest.MetadataSourceRequestBody requestBody)
    Remove the metadata element representing a topic.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateEventType(String serverName, String userId, String eventTypeGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeRequestBody requestBody)
    Update the metadata element representing a event type.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    updateTopic(String serverName, String userId, String topicGUID, boolean isMergeUpdate, org.odpi.openmetadata.accessservices.datamanager.rest.TopicRequestBody requestBody)
    Update the metadata element representing a topic.
    org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse
    withdrawTopic(String serverName, String userId, String topicGUID, org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody nullRequestBody)
    Update the zones for the topic asset so that it is no longer visible to consumers.

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • EventBrokerResource

      public EventBrokerResource()
      Default constructor

  • Method Details

    • createTopic

      @PostMapping(path="/topics") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createTopic(@PathVariable String serverName, @PathVariable String userId, @RequestParam boolean eventBrokerIsHome, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.TopicRequestBody requestBody)
      Create a new metadata element to represent a topic.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventBrokerIsHome - should the topic be marked as owned by the event broker so others can not update?
      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)

    • createTopicFromTemplate

      @PostMapping(path="/topics/from-template/{templateGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createTopicFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @RequestParam boolean eventBrokerIsHome, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.TemplateRequestBody requestBody)
      Create a new metadata element to represent a topic using an existing metadata element as a template.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventBrokerIsHome - should the topic be marked as owned by the event broker so others can not update?
      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)

    • updateTopic

      @PostMapping(path="/topics/{topicGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateTopic(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.TopicRequestBody requestBody)
      Update the metadata element representing a topic.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the metadata element to update
      isMergeUpdate - are unspecified properties unchanged (true) or removed?
      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)

    • publishTopic

      @PostMapping(path="/topics/{topicGUID}/publish") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse publishTopic(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody nullRequestBody)
      Update the zones for the topic asset so that it becomes visible to consumers. (The zones are set to the list of zones in the publishedZones option configured for each instance of the Data Manager OMAS).
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the metadata element to publish
      nullRequestBody - empty request body
      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)

    • withdrawTopic

      @PostMapping(path="/topics/{topicGUID}/withdraw") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse withdrawTopic(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @RequestBody(required=false) org.odpi.openmetadata.commonservices.ffdc.rest.NullRequestBody nullRequestBody)
      Update the zones for the topic asset so that it is no longer visible to consumers. (The zones are set to the list of zones in the defaultZones option configured for each instance of the Data Manager OMAS. This is the setting when the topic is first created).
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the metadata element to withdraw
      nullRequestBody - empty request body
      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)

    • removeTopic

      @PostMapping(path="/topics/{topicGUID}/{qualifiedName}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeTopic(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @PathVariable String qualifiedName, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.MetadataSourceRequestBody requestBody)
      Remove the metadata element representing a topic.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the metadata element to remove
      qualifiedName - unique name 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)

    • findTopics

      @PostMapping(path="/topics/by-search-string") public org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse findTopics(@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 topic 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)

    • getTopicsByName

      @PostMapping(path="/topics/by-name") public org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse getTopicsByName(@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 topic 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)

    • getTopicsForEventBroker

      @GetMapping(path="/event-brokers/{eventBrokerGUID}/{eventBrokerName}/topics") public org.odpi.openmetadata.accessservices.datamanager.rest.TopicsResponse getTopicsForEventBroker(@PathVariable String serverName, @PathVariable String userId, @PathVariable String eventBrokerGUID, @PathVariable String eventBrokerName, @RequestParam int startFrom, @RequestParam int pageSize)
      Retrieve the list of topics created by this topic manager.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventBrokerGUID - unique identifier of software server capability representing the owning event broker
      eventBrokerName - unique name of software server capability representing the owning event broker
      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)

    • getTopicByGUID

      @GetMapping(path="/topics/{guid}") public org.odpi.openmetadata.accessservices.datamanager.rest.TopicResponse getTopicByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String guid)
      Retrieve the topic 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)

    • createEventType

      @PostMapping(path="/topics/{topicGUID}/event-types") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createEventType(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeRequestBody requestBody)
      Create a new metadata element to represent a event type.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the topic where the event type is located
      requestBody - properties about the event type
      Returns:
      unique identifier of the new event type 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)

    • createEventTypeFromTemplate

      @PostMapping(path="/topics/{topicGUID}/event-types/from-template/{templateGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.GUIDResponse createEventTypeFromTemplate(@PathVariable String serverName, @PathVariable String userId, @PathVariable String templateGUID, @PathVariable String topicGUID, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.TemplateRequestBody requestBody)
      Create a new metadata element to represent a event type 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
      topicGUID - unique identifier of the topic where the event type is located
      requestBody - properties that override the template
      Returns:
      unique identifier of the new event type 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)

    • updateEventType

      @PostMapping(path="/topics/event-types/{eventTypeGUID}") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse updateEventType(@PathVariable String serverName, @PathVariable String userId, @PathVariable String eventTypeGUID, @RequestParam boolean isMergeUpdate, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeRequestBody requestBody)
      Update the metadata element representing a event type.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventTypeGUID - unique identifier of the metadata element to update
      isMergeUpdate - are unspecified properties unchanged (true) or removed?
      requestBody - new properties for the metadata 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)

    • removeEventType

      @PostMapping(path="/topics/event-types/{eventTypeGUID}/{qualifiedName}/delete") public org.odpi.openmetadata.commonservices.ffdc.rest.VoidResponse removeEventType(@PathVariable String serverName, @PathVariable String userId, @PathVariable String eventTypeGUID, @PathVariable String qualifiedName, @RequestBody org.odpi.openmetadata.accessservices.datamanager.rest.MetadataSourceRequestBody requestBody)
      Remove the metadata element representing a event type.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventTypeGUID - unique identifier of the metadata element to remove
      qualifiedName - unique name of the metadata element to remove
      requestBody - empty request body
      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)

    • findEventTypes

      @PostMapping(path="/topics/event-types/by-search-string") public org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse findEventTypes(@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 event type 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)

    • getEventTypesForEventSet

      @GetMapping(path="/event-sets/{eventSetGUID}/event-types") public org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse getEventTypesForEventSet(@PathVariable String serverName, @PathVariable String userId, @PathVariable String eventSetGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return the list of event types associated with a EventSet.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      eventSetGUID - unique identifier of the event set to query
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of metadata elements describing the schemas associated with the requested topic 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)

    • getEventTypesForTopic

      @GetMapping(path="/topics/{topicGUID}/event-types") public org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse getEventTypesForTopic(@PathVariable String serverName, @PathVariable String userId, @PathVariable String topicGUID, @RequestParam int startFrom, @RequestParam int pageSize)
      Return the list of schemas associated with a topic.
      Parameters:
      serverName - name of the service to route the request to.
      userId - calling user
      topicGUID - unique identifier of the topic to query
      startFrom - paging start point
      pageSize - maximum results that can be returned
      Returns:
      list of metadata elements describing the schemas associated with the requested topic 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)

    • getEventTypesByName

      @PostMapping(path="/topics/event-types/by-name") public org.odpi.openmetadata.accessservices.datamanager.rest.EventTypesResponse getEventTypesByName(@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 event type 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)

    • getEventTypeByGUID

      @GetMapping(path="/topics/event-types/{guid}") public org.odpi.openmetadata.accessservices.datamanager.rest.EventTypeResponse getEventTypeByGUID(@PathVariable String serverName, @PathVariable String userId, @PathVariable String guid)
      Retrieve the event type 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:
      requested 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)