Constructor Detail

• PropertySchemaService

  public PropertySchemaService(net.brokenbuild.subcomponents.service.customprops.propschema.PropSchemaMapper propSchemaMapper,
                               net.brokenbuild.subcomponents.service.customprops.propschema.PropSchemaHelper propSchemaHelper)

Method Detail

• get

  public java.util.Optional<PropSchemaDto> get(int schemaId)

  Retrieves a property schema based on the provided schema ID.

  This method fetches a property schema associated with a specific ID. If the schema exists, it's mapped to its DTO representation. If the user is unauthorized to access this data, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  schemaId - The ID of the property schema to be retrieved.

  Returns:

  An Optional containing the PropSchemaDto if found, or an empty Optional if not found.

  Throws:

  SubcomponentsAuthException - if the user is unauthorized to access the property schema.

  SubcomponentsApiException - if any other error occurs while fetching the property schema.

  Since:

  3.9.0

• list

  public java.util.List<PropSchemaDto> list(PropSchemaTypeEnum schemaType)

  Retrieves a list of property schemas based on the given schema type.

  This method fetches all property schemas associated with a specific schema type. If the user is unauthorized to access this data, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  schemaType - The type of the property schemas to be retrieved.

  Returns:

  A list of PropSchemaDto matching the given schema type.

  Throws:

  SubcomponentsAuthException - if the user is unauthorized to access the list of property schemas.

  SubcomponentsApiException - if any other error occurs while fetching the list of property schemas.

  Since:

  3.9.0

• getByProjectKey

  public java.util.Optional<PropSchemaDto> getByProjectKey(java.lang.String projectKey,
                                                           PropSchemaTypeEnum schemaType)

  Retrieves a property schema based on the given project key and schema type.

  This method fetches a property schema associated with a specific project key and schema type. If the user is unauthorized to access this data, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  projectKey - The project key associated with the property schema.

  schemaType - The type of the property schema to be retrieved.

  Returns:

  An Optional containing the PropSchemaDto if found, or an empty Optional if not found.

  Throws:

  SubcomponentsAuthException - if the user is unauthorized to access the property schema.

  SubcomponentsApiException - if any other error occurs while fetching the property schema.

  Since:

  3.9.0

• create

  public PropSchemaDto create(PropSchemaCreateDto input)

  Creates a new property schema based on the given input data.

  This method attempts to create a new property schema using the information provided in the input data. If the provided input data doesn't pass validation, a SubcomponentsValidationException is thrown. If the user is unauthorized to create the schema, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  input - A data transfer object PropSchemaCreateDto containing the necessary information to create the property schema.

  Returns:

  A PropSchemaDto representing the newly created property schema.

  Throws:

  SubcomponentsValidationException - if the input data fails validation checks.

  SubcomponentsAuthException - if the user is unauthorized to create the schema.

  SubcomponentsApiException - if any other error occurs while creating the schema.

  Since:

  3.9.0

• update

  public PropSchemaDto update(PropSchemaUpdateDto input)

  Updates a property schema based on the given input data.

  This method attempts to update an existing property schema using the information provided in the input data. If the provided input data doesn't pass validation, a SubcomponentsValidationException is thrown. If the user is unauthorized to update the schema, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  input - A data transfer object PropSchemaUpdateDto containing the necessary information to update the property schema.

  Returns:

  A PropSchemaDto representing the updated property schema.

  Throws:

  SubcomponentsValidationException - if the input data fails validation checks.

  SubcomponentsAuthException - if the user is unauthorized to update the schema.

  SubcomponentsApiException - if any other error occurs while updating the schema.

  Since:

  3.9.0

• delete

  public void delete(int schemaId)

  Deletes a property schema based on the given schema ID.

  This method attempts to delete an existing property schema using the provided schema ID. If the user is unauthorized to delete this schema, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  schemaId - The ID of the property schema to be deleted.

  Throws:

  SubcomponentsAuthException - if the user is unauthorized to delete the property schema.

  SubcomponentsApiException - if any other error occurs while deleting the property schema.

  Since:

  3.9.0

• assign

  public void assign(int schemaId,
                     java.lang.String projectKey)

  Assigns a property schema to a project based on the given schema ID and project key.

  This method attempts to associate an existing property schema (identified by its ID) with a project (identified by its key). If the user is unauthorized to perform this action, a SubcomponentsAuthException is thrown. For other unexpected errors, a SubcomponentsApiException is thrown.

  Parameters:

  schemaId - The ID of the property schema to be assigned.

  projectKey - The key of the project to which the schema should be assigned.

  Throws:

  SubcomponentsAuthException - if the user is unauthorized to assign the property schema to the project.

  SubcomponentsApiException - if any other error occurs while assigning the property schema to the project.

  Since:

  3.9.0