| /** |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you 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 org.apache.hadoop.hdfs.server.namenode; |
| |
| import java.io.DataInput; |
| import java.io.DataOutput; |
| import java.io.IOException; |
| |
| import org.apache.hadoop.classification.InterfaceAudience; |
| import org.apache.hadoop.hdfs.server.common.StorageInfo; |
| import org.apache.hadoop.hdfs.server.namenode.FSImage; |
| import org.apache.hadoop.io.MD5Hash; |
| import org.apache.hadoop.io.WritableComparable; |
| import org.apache.hadoop.io.WritableUtils; |
| |
| /** |
| * A unique signature intended to identify checkpoint transactions. |
| */ |
| @InterfaceAudience.Private |
| public class CheckpointSignature extends StorageInfo |
| implements WritableComparable<CheckpointSignature> { |
| private static final String FIELD_SEPARATOR = ":"; |
| long editsTime = -1L; |
| long checkpointTime = -1L; |
| MD5Hash imageDigest = null; |
| String blockpoolID = ""; |
| |
| public CheckpointSignature() {} |
| |
| CheckpointSignature(FSImage fsImage) { |
| super(fsImage.getStorage()); |
| blockpoolID = fsImage.getBlockPoolID(); |
| editsTime = fsImage.getEditLog().getFsEditTime(); |
| checkpointTime = fsImage.getStorage().getCheckpointTime(); |
| imageDigest = fsImage.getStorage().getImageDigest(); |
| checkpointTime = fsImage.getStorage().getCheckpointTime(); |
| } |
| |
| CheckpointSignature(String str) { |
| String[] fields = str.split(FIELD_SEPARATOR); |
| assert fields.length == 8 : "Must be 8 fields in CheckpointSignature"; |
| layoutVersion = Integer.valueOf(fields[0]); |
| namespaceID = Integer.valueOf(fields[1]); |
| cTime = Long.valueOf(fields[2]); |
| editsTime = Long.valueOf(fields[3]); |
| checkpointTime = Long.valueOf(fields[4]); |
| imageDigest = new MD5Hash(fields[5]); |
| clusterID = fields[6]; |
| blockpoolID = fields[7]; |
| } |
| |
| /** |
| * Get the MD5 image digest |
| * @return the MD5 image digest |
| */ |
| MD5Hash getImageDigest() { |
| return imageDigest; |
| } |
| |
| /** |
| * Get the cluster id from CheckpointSignature |
| * @return the cluster id |
| */ |
| public String getClusterID() { |
| return clusterID; |
| } |
| |
| /** |
| * Get the block pool id from CheckpointSignature |
| * @return the block pool id |
| */ |
| public String getBlockpoolID() { |
| return blockpoolID; |
| } |
| |
| /** |
| * Set the block pool id of CheckpointSignature. |
| * |
| * @param blockpoolID the new blockpool id |
| */ |
| public void setBlockpoolID(String blockpoolID) { |
| this.blockpoolID = blockpoolID; |
| } |
| |
| public String toString() { |
| return String.valueOf(layoutVersion) + FIELD_SEPARATOR |
| + String.valueOf(namespaceID) + FIELD_SEPARATOR |
| + String.valueOf(cTime) + FIELD_SEPARATOR |
| + String.valueOf(editsTime) + FIELD_SEPARATOR |
| + String.valueOf(checkpointTime) + FIELD_SEPARATOR |
| + imageDigest.toString() + FIELD_SEPARATOR |
| + clusterID + FIELD_SEPARATOR |
| + blockpoolID ; |
| } |
| |
| void validateStorageInfo(FSImage si) throws IOException { |
| if(layoutVersion != si.getLayoutVersion() |
| || namespaceID != si.getNamespaceID() |
| || cTime != si.getStorage().cTime |
| || checkpointTime != si.getStorage().getCheckpointTime() |
| || !imageDigest.equals(si.getStorage().imageDigest) |
| || !clusterID.equals(si.getClusterID()) |
| || !blockpoolID.equals(si.getBlockPoolID())) { |
| // checkpointTime can change when the image is saved - do not compare |
| throw new IOException("Inconsistent checkpoint fields.\n" |
| + "LV = " + layoutVersion + " namespaceID = " + namespaceID |
| + " cTime = " + cTime + "; checkpointTime = " + checkpointTime |
| + " ; imageDigest = " + imageDigest |
| + " ; clusterId = " + clusterID |
| + " ; blockpoolId = " + blockpoolID |
| + ".\nExpecting respectively: " |
| + si.getLayoutVersion() + "; " |
| + si.getNamespaceID() + "; " + si.getStorage().cTime |
| + "; " + si.getStorage().getCheckpointTime() + "; " |
| + si.getStorage().imageDigest |
| + "; " + si.getClusterID() + "; " |
| + si.getBlockPoolID() + "."); |
| } |
| } |
| |
| // |
| // Comparable interface |
| // |
| public int compareTo(CheckpointSignature o) { |
| return |
| (layoutVersion < o.layoutVersion) ? -1 : |
| (layoutVersion > o.layoutVersion) ? 1 : |
| (namespaceID < o.namespaceID) ? -1 : (namespaceID > o.namespaceID) ? 1 : |
| (cTime < o.cTime) ? -1 : (cTime > o.cTime) ? 1 : |
| (editsTime < o.editsTime) ? -1 : (editsTime > o.editsTime) ? 1 : |
| (checkpointTime < o.checkpointTime) ? -1 : |
| (checkpointTime > o.checkpointTime) ? 1 : |
| (clusterID.compareTo(o.clusterID) < 0) ? -1 : |
| (clusterID.compareTo(o.clusterID) > 0) ? 1 : |
| (blockpoolID.compareTo(o.blockpoolID) < 0) ? -1 : |
| (blockpoolID.compareTo(o.blockpoolID) > 0) ? 1 : |
| imageDigest.compareTo(o.imageDigest); |
| } |
| |
| public boolean equals(Object o) { |
| if (!(o instanceof CheckpointSignature)) { |
| return false; |
| } |
| return compareTo((CheckpointSignature)o) == 0; |
| } |
| |
| public int hashCode() { |
| return layoutVersion ^ namespaceID ^ |
| (int)(cTime ^ editsTime ^ checkpointTime) ^ |
| imageDigest.hashCode() ^ clusterID.hashCode() |
| ^ blockpoolID.hashCode(); |
| } |
| |
| ///////////////////////////////////////////////// |
| // Writable |
| ///////////////////////////////////////////////// |
| public void write(DataOutput out) throws IOException { |
| super.write(out); |
| WritableUtils.writeString(out, blockpoolID); |
| out.writeLong(editsTime); |
| out.writeLong(checkpointTime); |
| imageDigest.write(out); |
| } |
| |
| public void readFields(DataInput in) throws IOException { |
| super.readFields(in); |
| blockpoolID = WritableUtils.readString(in); |
| editsTime = in.readLong(); |
| checkpointTime = in.readLong(); |
| imageDigest = new MD5Hash(); |
| imageDigest.readFields(in); |
| } |
| } |