Package io.github.primelib.confluence4j.rest.v1.spec

Klasse GetContentCommentsOperationSpec

java.lang.Object
io.github.primelib.confluence4j.rest.v1.spec.GetContentCommentsOperationSpec
@Generated("io.github.primelib.primecodegen.javafeign.JavaFeignGenerator") public class GetContentCommentsOperationSpec extends Object
GetContentCommentsSpec

Specification for the GetContentComments operation.

Get content comments

  • Felddetails

    • VALIDATION_ENABLED

      @Experimental public static Boolean VALIDATION_ENABLED
      allows to disable validation of the spec, use with care!

  • Konstruktordetails

    • GetContentCommentsOperationSpec

      @Internal public GetContentCommentsOperationSpec(Consumer<GetContentCommentsOperationSpec> spec)
      Constructs a validated instance of GetContentCommentsOperationSpec.
      Parameter:
      spec - the specification to process

    • GetContentCommentsOperationSpec

      @Internal public GetContentCommentsOperationSpec(String id, List<String> expand, Integer parentVersion, Integer start, Integer limit, List<String> location, String depth)
      Constructs a validated instance of GetContentCommentsOperationSpec.

      NOTE: This constructor is not considered stable and may change if the operation is updated.

      Parameter:
      id - The ID of the content to be queried for its comments.
      expand - A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      parentVersion - The version of the parent content to retrieve children for. Currently, this only works for the latest version.
      start - The starting index of the returned comments.
      limit - The maximum number of comments to return per page. Note, this may be restricted by fixed system limits.
      location - The location of the comments in the page. Multiple locations can be specified. If no location is specified, comments from all locations are returned.
      depth - Currently, this parameter is not used. Comments are returned at the root level only.

    • GetContentCommentsOperationSpec

      protected GetContentCommentsOperationSpec()

  • Methodendetails

    • validate

      public void validate()
      Validates the Spec, will throw a exception if required parameters are missing
      Löst aus:
      NullPointerException

    • builder

      public static GetContentCommentsOperationSpec.GetContentCommentsOperationSpecBuilder builder()

    • id

      @NotNull public @NotNull String id()
      The ID of the content to be queried for its comments.

    • expand

      @Nullable public @Nullable List<String> expand()
      A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.

    • parentVersion

      @Nullable public @Nullable Integer parentVersion()
      The version of the parent content to retrieve children for. Currently, this only works for the latest version.

    • start

      @Nullable public @Nullable Integer start()
      The starting index of the returned comments.

    • limit

      @Nullable public @Nullable Integer limit()
      The maximum number of comments to return per page. Note, this may be restricted by fixed system limits.

    • location

      @Nullable public @Nullable List<String> location()
      The location of the comments in the page. Multiple locations can be specified. If no location is specified, comments from all locations are returned.

    • depth

      @Nullable public @Nullable String depth()
      Currently, this parameter is not used. Comments are returned at the root level only.

    • id

      public GetContentCommentsOperationSpec id(@NotNull @NotNull String id)
      The ID of the content to be queried for its comments.
      Gibt zurück:
      this.

    • expand

      public GetContentCommentsOperationSpec expand(@Nullable @Nullable List<String> expand)
      A multi-value parameter indicating which properties of the content to expand. - childTypes.all returns whether the content has attachments, comments, or child pages/whiteboards. Use this if you only need to check whether the content has children of a particular type. - childTypes.attachment returns whether the content has attachments. - childTypes.comment returns whether the content has comments. - childTypes.page returns whether the content has child pages. - container returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). - metadata.currentuser returns information about the current user in relation to the content, including when they last viewed it, modified it, contributed to it, or added it as a favorite. - metadata.properties returns content properties that have been set via the Confluence REST API. - metadata.labels returns the labels that have been added to the content. - metadata.frontend this property is only used by Atlassian. - operations returns the operations for the content, which are used when setting permissions. - children.page returns pages that are descendants at the level immediately below the content. - children.attachment returns all attachments for the content. - children.comment returns all comments on the content. - restrictions.read.restrictions.user returns the users that have permission to read the content. - restrictions.read.restrictions.group returns the groups that have permission to read the content. Note that this may return deleted groups, because deleting a group doesn't remove associated restrictions. - restrictions.update.restrictions.user returns the users that have permission to update the content. - restrictions.update.restrictions.group returns the groups that have permission to update the content. Note that this may return deleted groups because deleting a group doesn't remove associated restrictions. - history returns the history of the content, including the date it was created. - history.lastUpdated returns information about the most recent update of the content, including who updated it and when it was updated. - history.previousVersion returns information about the update prior to the current content update. - history.contributors returns all of the users who have contributed to the content. - history.nextVersion returns information about the update after to the current content update. - ancestors returns the parent content, if the content is a page or whiteboard. - body returns the body of the content in different formats, including the editor format, view format, and export format. - body.storage returns the body of content in storage format. - body.view returns the body of content in view format. - version returns information about the most recent update of the content, including who updated it and when it was updated. - descendants.page returns pages that are descendants at any level below the content. - descendants.attachment returns all attachments for the content, same as children.attachment. - descendants.comment returns all comments on the content, same as children.comment. - space returns the space that the content is in. This is the same as the information returned by [Get space](#api-space-spaceKey-get). In addition, the following comment-specific expansions can be used: - extensions.inlineProperties returns inline comment-specific properties. - extensions.resolution returns the resolution status of each comment.
      Gibt zurück:
      this.

    • parentVersion

      public GetContentCommentsOperationSpec parentVersion(@Nullable @Nullable Integer parentVersion)
      The version of the parent content to retrieve children for. Currently, this only works for the latest version.
      Gibt zurück:
      this.

    • start

      public GetContentCommentsOperationSpec start(@Nullable @Nullable Integer start)
      The starting index of the returned comments.
      Gibt zurück:
      this.

    • limit

      public GetContentCommentsOperationSpec limit(@Nullable @Nullable Integer limit)
      The maximum number of comments to return per page. Note, this may be restricted by fixed system limits.
      Gibt zurück:
      this.

    • location

      public GetContentCommentsOperationSpec location(@Nullable @Nullable List<String> location)
      The location of the comments in the page. Multiple locations can be specified. If no location is specified, comments from all locations are returned.
      Gibt zurück:
      this.

    • depth

      public GetContentCommentsOperationSpec depth(@Nullable @Nullable String depth)
      Currently, this parameter is not used. Comments are returned at the root level only.
      Gibt zurück:
      this.

    • equals

      public boolean equals(Object o)
      Setzt außer Kraft:
      equals in Klasse Object

    • canEqual

      protected boolean canEqual(Object other)

    • hashCode

      public int hashCode()
      Setzt außer Kraft:
      hashCode in Klasse Object

    • toString

      public String toString()
      Setzt außer Kraft:
      toString in Klasse Object