com.google.gerrit.server.account

Class InternalAccountUpdate.Builder

java.lang.Object

com.google.gerrit.server.account.InternalAccountUpdate.Builder

Enclosing class:

InternalAccountUpdate

public abstract static class InternalAccountUpdate.Builder
extends java.lang.Object

Class to build an account update.

Account data is only updated if the corresponding setter is invoked. If a setter is not invoked the corresponding data stays unchanged. To unset string values the setter can be invoked with either null or an empty string (null is converted to an empty string by using the WrapperThatConvertsNullStringArgsToEmptyStrings wrapper, see InternalAccountUpdate.builder()).

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
InternalAccountUpdate.Builder	addExternalId(ExternalId extId) Adds a new external ID for the account.
InternalAccountUpdate.Builder	addExternalIds(java.util.Collection<ExternalId> extIds) Adds new external IDs for the account.
abstract InternalAccountUpdate	build() Builds the account update.
InternalAccountUpdate.Builder	deleteExternalId(ExternalId extId) Deletes an external ID for the account.
InternalAccountUpdate.Builder	deleteExternalIds(java.util.Collection<ExternalId> extIds) Deletes external IDs for the account.
InternalAccountUpdate.Builder	deleteProjectWatch(ProjectWatches.ProjectWatchKey projectWatch) Deletes a project watch for the account.
InternalAccountUpdate.Builder	deleteProjectWatches(java.util.Collection<ProjectWatches.ProjectWatchKey> projectWatches) Deletes project watches for the account.
InternalAccountUpdate.Builder	replaceExternalId(ExternalId extIdToDelete, ExternalId extIdToAdd) Replaces an external ID.
InternalAccountUpdate.Builder	replaceExternalIds(java.util.Collection<ExternalId> extIdsToDelete, java.util.Collection<ExternalId> extIdsToAdd) Replaces an external IDs.
abstract InternalAccountUpdate.Builder	setActive(boolean active) Sets the active flag for the account.
abstract InternalAccountUpdate.Builder	setDiffPreferences(DiffPreferencesInfo diffPreferences) Sets the diff preferences for the account.
abstract InternalAccountUpdate.Builder	setEditPreferences(EditPreferencesInfo editPreferences) Sets the edit preferences for the account.
abstract InternalAccountUpdate.Builder	setFullName(java.lang.String fullName) Sets a new full name for the account.
abstract InternalAccountUpdate.Builder	setGeneralPreferences(GeneralPreferencesInfo generalPreferences) Sets the general preferences for the account.
abstract InternalAccountUpdate.Builder	setPreferredEmail(java.lang.String preferredEmail) Sets a new preferred email for the account.
abstract InternalAccountUpdate.Builder	setStatus(java.lang.String status) Sets a new status for the account.
InternalAccountUpdate.Builder	updateExternalId(ExternalId extId) Updates an external ID for the account.
InternalAccountUpdate.Builder	updateExternalIds(java.util.Collection<ExternalId> extIds) Updates external IDs for the account.
InternalAccountUpdate.Builder	updateProjectWatch(ProjectWatches.ProjectWatchKey projectWatchKey, java.util.Set<ProjectWatches.NotifyType> notifyTypes) Updates a project watch for the account.
InternalAccountUpdate.Builder	updateProjectWatches(java.util.Map<ProjectWatches.ProjectWatchKey,java.util.Set<ProjectWatches.NotifyType>> projectWatches) Updates project watches for the account.

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

setFullName

public abstract InternalAccountUpdate.Builder setFullName(java.lang.String fullName)

Sets a new full name for the account.

Parameters:

fullName - the new full name, if null or empty string the full name is unset

Returns:

the builder

setPreferredEmail

public abstract InternalAccountUpdate.Builder setPreferredEmail(java.lang.String preferredEmail)

Sets a new preferred email for the account.

Parameters:

preferredEmail - the new preferred email, if null or empty string the preferred email is unset

Returns:

the builder

setActive

public abstract InternalAccountUpdate.Builder setActive(boolean active)

Sets the active flag for the account.

Parameters:

active - true if the account should be set to active, false if the account should be set to inactive

Returns:

the builder

setStatus

public abstract InternalAccountUpdate.Builder setStatus(java.lang.String status)

Sets a new status for the account.

Parameters:

status - the new status, if null or empty string the status is unset

Returns:

the builder

addExternalId

public InternalAccountUpdate.Builder addExternalId(ExternalId extId)

Adds a new external ID for the account.

The account ID of the external ID must match the account ID of the account that is updated.

If an external ID with the same ID already exists the account update will fail with DuplicateExternalIdKeyException.

Parameters:

extId - external ID that should be added

Returns:

the builder

addExternalIds

public InternalAccountUpdate.Builder addExternalIds(java.util.Collection<ExternalId> extIds)

Adds new external IDs for the account.

The account IDs of the external IDs must match the account ID of the account that is updated.

If any of the external ID keys already exists, the insert fails with DuplicateExternalIdKeyException.

Parameters:

extIds - external IDs that should be added

Returns:

the builder

updateExternalId

public InternalAccountUpdate.Builder updateExternalId(ExternalId extId)

Updates an external ID for the account.

The account ID of the external ID must match the account ID of the account that is updated.

If no external ID with the ID exists the external ID is created.

Parameters:

extId - external ID that should be updated

Returns:

the builder

updateExternalIds

public InternalAccountUpdate.Builder updateExternalIds(java.util.Collection<ExternalId> extIds)

Updates external IDs for the account.

The account IDs of the external IDs must match the account ID of the account that is updated.

If any of the external IDs already exists, it is overwritten. New external IDs are inserted.

Parameters:

extIds - external IDs that should be updated

Returns:

the builder

deleteExternalId

public InternalAccountUpdate.Builder deleteExternalId(ExternalId extId)

Deletes an external ID for the account.

The account ID of the external ID must match the account ID of the account that is updated.

If no external ID with the ID exists this is a no-op.

Parameters:

extId - external ID that should be deleted

Returns:

the builder

deleteExternalIds

public InternalAccountUpdate.Builder deleteExternalIds(java.util.Collection<ExternalId> extIds)

Deletes external IDs for the account.

The account IDs of the external IDs must match the account ID of the account that is updated.

For non-existing external IDs this is a no-op.

Parameters:

extIds - external IDs that should be deleted

Returns:

the builder

replaceExternalId

public InternalAccountUpdate.Builder replaceExternalId(ExternalId extIdToDelete,
                                                       ExternalId extIdToAdd)

Replaces an external ID.

Parameters:

extIdToDelete - external ID that should be deleted

extIdToAdd - external ID that should be added

Returns:

the builder

replaceExternalIds

public InternalAccountUpdate.Builder replaceExternalIds(java.util.Collection<ExternalId> extIdsToDelete,
                                                        java.util.Collection<ExternalId> extIdsToAdd)

Replaces an external IDs.

Parameters:

extIdsToDelete - external IDs that should be deleted

extIdsToAdd - external IDs that should be added

Returns:

the builder

updateProjectWatch

public InternalAccountUpdate.Builder updateProjectWatch(ProjectWatches.ProjectWatchKey projectWatchKey,
                                                        java.util.Set<ProjectWatches.NotifyType> notifyTypes)

Updates a project watch for the account.

If no project watch with the key exists the project watch is created.

Parameters:

projectWatchKey - key of the project watch that should be updated

notifyTypes - the notify types that should be set for the project watch

Returns:

the builder

updateProjectWatches

public InternalAccountUpdate.Builder updateProjectWatches(java.util.Map<ProjectWatches.ProjectWatchKey,java.util.Set<ProjectWatches.NotifyType>> projectWatches)

Updates project watches for the account.

If any of the project watches already exists, it is overwritten. New project watches are inserted.

Parameters:

projectWatches - project watches that should be updated

Returns:

the builder

deleteProjectWatch

public InternalAccountUpdate.Builder deleteProjectWatch(ProjectWatches.ProjectWatchKey projectWatch)

Deletes a project watch for the account.

If no project watch with the ID exists this is a no-op.

Parameters:

projectWatch - project watch that should be deleted

Returns:

the builder

deleteProjectWatches

public InternalAccountUpdate.Builder deleteProjectWatches(java.util.Collection<ProjectWatches.ProjectWatchKey> projectWatches)

Deletes project watches for the account.

For non-existing project watches this is a no-op.

Parameters:

projectWatches - project watches that should be deleted

Returns:

the builder

setGeneralPreferences

public abstract InternalAccountUpdate.Builder setGeneralPreferences(GeneralPreferencesInfo generalPreferences)

Sets the general preferences for the account.

Updates any preference that is non-null in the provided GeneralPreferencesInfo.

Parameters:

generalPreferences - the general preferences that should be set

Returns:

the builder

setDiffPreferences

public abstract InternalAccountUpdate.Builder setDiffPreferences(DiffPreferencesInfo diffPreferences)

Sets the diff preferences for the account.

Updates any preference that is non-null in the provided DiffPreferencesInfo.

Parameters:

diffPreferences - the diff preferences that should be set

Returns:

the builder

setEditPreferences

public abstract InternalAccountUpdate.Builder setEditPreferences(EditPreferencesInfo editPreferences)

Sets the edit preferences for the account.

Updates any preference that is non-null in the provided EditPreferencesInfo.

Parameters:

editPreferences - the edit preferences that should be set

Returns:

the builder

build

public abstract InternalAccountUpdate build()

Builds the account update.

Returns:

the account update