// Copyright (C) 2008 The Android Open Source Project // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package com.google.gerrit.reviewdb.client; import com.google.gwtorm.client.Column; import com.google.gwtorm.client.StringKey; import java.sql.Timestamp; import java.util.Objects; /** A message attached to a {@link Change}. */ public final class ChangeMessage { public static class Key extends StringKey<Change.Id> { private static final long serialVersionUID = 1L; @Column(id = 1) protected Change.Id changeId; @Column(id = 2, length = 40) protected String uuid; protected Key() { changeId = new Change.Id(); } public Key(final Change.Id change, final String uuid) { this.changeId = change; this.uuid = uuid; } @Override public Change.Id getParentKey() { return changeId; } @Override public String get() { return uuid; } @Override public void set(String newValue) { uuid = newValue; } } @Column(id = 1, name = Column.NONE) protected Key key; /** Who wrote this comment; null if it was written by the Gerrit system. */ @Column(id = 2, name = "author_id", notNull = false) protected Account.Id author; /** When this comment was drafted. */ @Column(id = 3) protected Timestamp writtenOn; /** The text left by the user. */ @Column(id = 4, notNull = false, length = Integer.MAX_VALUE) protected String message; /** Which patchset (if any) was this message generated from? */ @Column(id = 5, notNull = false) protected PatchSet.Id patchset; /** Tag associated with change message */ @Column(id = 6, notNull = false) protected String tag; /** Real user that added this message on behalf of the user recorded in {@link #author}. */ @Column(id = 7, notNull = false) protected Account.Id realAuthor; protected ChangeMessage() {} public ChangeMessage( final ChangeMessage.Key k, final Account.Id a, final Timestamp wo, final PatchSet.Id psid) { key = k; author = a; writtenOn = wo; patchset = psid; } public ChangeMessage.Key getKey() { return key; } /** If null, the message was written 'by the Gerrit system'. */ public Account.Id getAuthor() { return author; } public void setAuthor(final Account.Id accountId) { if (author != null) { throw new IllegalStateException("Cannot modify author once assigned"); } author = accountId; } public Account.Id getRealAuthor() { return realAuthor != null ? realAuthor : getAuthor(); } public void setRealAuthor(Account.Id id) { // Use null for same real author, as before the column was added. realAuthor = Objects.equals(getAuthor(), id) ? null : id; } public Timestamp getWrittenOn() { return writtenOn; } public void setWrittenOn(Timestamp ts) { writtenOn = ts; } public String getMessage() { return message; } public void setMessage(final String s) { message = s; } public String getTag() { return tag; } public void setTag(String tag) { this.tag = tag; } public PatchSet.Id getPatchSetId() { return patchset; } public void setPatchSetId(PatchSet.Id id) { patchset = id; } @Override public String toString() { return "ChangeMessage{" + "key=" + key + ", author=" + author + ", realAuthor=" + realAuthor + ", writtenOn=" + writtenOn + ", patchset=" + patchset + ", tag=" + tag + ", message=[" + message + "]}"; } }