Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
// Copyright (C) 2016 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.server.change;
import com.google.common.base.Throwables;
import com.google.common.cache.Cache;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableSet;
import com.google.common.collect.Sets;
import com.google.common.primitives.Ints;
import com.google.gerrit.extensions.restapi.DeprecatedIdentifierException;
import com.google.gerrit.extensions.restapi.Url;
import com.google.gerrit.index.IndexConfig;
import com.google.gerrit.metrics.Counter1;
import com.google.gerrit.metrics.Description;
import com.google.gerrit.metrics.Field;
import com.google.gerrit.metrics.MetricMaker;
import com.google.gerrit.reviewdb.client.Change;
import com.google.gerrit.reviewdb.client.Project;
import com.google.gerrit.reviewdb.client.RevId;
import com.google.gerrit.reviewdb.server.ReviewDb;
import com.google.gerrit.server.cache.CacheModule;
import com.google.gerrit.server.config.ConfigUtil;
import com.google.gerrit.server.config.GerritServerConfig;
import com.google.gerrit.server.notedb.ChangeNotes;
import com.google.gerrit.server.project.NoSuchChangeException;
import com.google.gerrit.server.query.change.ChangeData;
import com.google.gerrit.server.query.change.InternalChangeQuery;
import com.google.gwtorm.server.OrmException;
import com.google.inject.Inject;
import com.google.inject.Module;
import com.google.inject.Provider;
import com.google.inject.Singleton;
import com.google.inject.name.Named;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.Optional;
import java.util.Set;
import org.eclipse.jgit.errors.RepositoryNotFoundException;
import org.eclipse.jgit.lib.Config;
@Singleton
public class ChangeFinder {
private static final String CACHE_NAME = "changeid_project";
public static Module module() {
return new CacheModule() {
@Override
protected void configure() {
cache(CACHE_NAME, Change.Id.class, String.class).maximumWeight(1024);
}
};
}
public enum ChangeIdType {
ALL,
TRIPLET,
NUMERIC_ID,
I_HASH,
PROJECT_NUMERIC_ID,
COMMIT_HASH
}
private final IndexConfig indexConfig;
private final Cache changeIdProjectCache;
private final Provider queryProvider;
private final Provider reviewDb;
private final ChangeNotes.Factory changeNotesFactory;
private final Counter1 changeIdCounter;
private final ImmutableSet allowedIdTypes;
@Inject
ChangeFinder(
IndexConfig indexConfig,
@Named(CACHE_NAME) Cache changeIdProjectCache,
Provider queryProvider,
Provider reviewDb,
ChangeNotes.Factory changeNotesFactory,
MetricMaker metricMaker,
@GerritServerConfig Config config) {
this.indexConfig = indexConfig;
this.changeIdProjectCache = changeIdProjectCache;
this.queryProvider = queryProvider;
this.reviewDb = reviewDb;
this.changeNotesFactory = changeNotesFactory;
this.changeIdCounter =
metricMaker.newCounter(
"http/server/rest_api/change_id_type",
new Description("Total number of API calls per identifier type.")
.setRate()
.setUnit("requests"),
Field.ofEnum(ChangeIdType.class, "change_id_type"));
List configuredChangeIdTypes =
ConfigUtil.getEnumList(config, "change", "api", "allowedIdentifier", ChangeIdType.ALL);
// Ensure that PROJECT_NUMERIC_ID can't be removed
configuredChangeIdTypes.add(ChangeIdType.PROJECT_NUMERIC_ID);
this.allowedIdTypes = ImmutableSet.copyOf(configuredChangeIdTypes);
}
public ChangeNotes findOne(String id) throws OrmException {
List ctls = find(id);
if (ctls.size() != 1) {
return null;
}
return ctls.get(0);
}
/**
* Find changes matching the given identifier.
*
* @param id change identifier.
* @return possibly-empty list of notes for all matching changes; may or may not be visible.
* @throws OrmException if an error occurred querying the database.
*/
public List find(String id) throws OrmException {
try {
return find(id, false);
} catch (DeprecatedIdentifierException e) {
// This can't happen because we don't enforce deprecation
throw new OrmException(e);
}
}
/**
* Find changes matching the given identifier.
*
* @param id change identifier.
* @param enforceDeprecation boolean to see if we should throw {@link
* DeprecatedIdentifierException} in case the identifier is deprecated
* @return possibly-empty list of notes for all matching changes; may or may not be visible.
* @throws OrmException if an error occurred querying the database
* @throws DeprecatedIdentifierException if the identifier is deprecated.
*/
public List find(String id, boolean enforceDeprecation)
throws OrmException, DeprecatedIdentifierException {
if (id.isEmpty()) {
return Collections.emptyList();
}
int z = id.lastIndexOf('~');
int y = id.lastIndexOf('~', z - 1);
if (y < 0 && z > 0) {
// Try project~numericChangeId
Integer n = Ints.tryParse(id.substring(z + 1));
if (n != null) {
checkIdType(ChangeIdType.PROJECT_NUMERIC_ID, enforceDeprecation, n.toString());
return fromProjectNumber(id.substring(0, z), n.intValue());
}
}
if (y < 0 && z < 0) {
// Try numeric changeId
Integer n = Ints.tryParse(id);
if (n != null) {
checkIdType(ChangeIdType.NUMERIC_ID, enforceDeprecation, n.toString());
return find(new Change.Id(n));
}
}
// Use the index to search for changes, but don't return any stored fields,
// to force rereading in case the index is stale.
InternalChangeQuery query = queryProvider.get().noFields();
// Try commit hash
if (id.matches("^([0-9a-fA-F]{" + RevId.ABBREV_LEN + "," + RevId.LEN + "})$")) {
checkIdType(ChangeIdType.COMMIT_HASH, enforceDeprecation, id);
return asChangeNotes(query.byCommit(id));
}
if (y > 0 && z > 0) {
// Try change triplet (project~branch~Ihash...)
Optional triplet = ChangeTriplet.parse(id, y, z);
if (triplet.isPresent()) {
ChangeTriplet t = triplet.get();
checkIdType(ChangeIdType.TRIPLET, enforceDeprecation, triplet.get().toString());
return asChangeNotes(query.byBranchKey(t.branch(), t.id()));
}
}
// Try isolated Ihash... format ("Change-Id: Ihash").
List notes = asChangeNotes(query.byKeyPrefix(id));
if (!notes.isEmpty()) {
checkIdType(ChangeIdType.I_HASH, enforceDeprecation, id);
}
return notes;
}
private List fromProjectNumber(String project, int changeNumber)
throws OrmException {
Change.Id cId = new Change.Id(changeNumber);
try {
return ImmutableList.of(
changeNotesFactory.createChecked(reviewDb.get(), Project.NameKey.parse(project), cId));
} catch (NoSuchChangeException e) {
return Collections.emptyList();
} catch (OrmException e) {
// Distinguish between a RepositoryNotFoundException (project argument invalid) and
// other OrmExceptions (failure in the persistence layer).
if (Throwables.getRootCause(e) instanceof RepositoryNotFoundException) {
return Collections.emptyList();
}
throw e;
}
}
public ChangeNotes findOne(Change.Id id) throws OrmException {
List notes = find(id);
if (notes.size() != 1) {
throw new NoSuchChangeException(id);
}
return notes.get(0);
}
public List find(Change.Id id) throws OrmException {
String project = changeIdProjectCache.getIfPresent(id);
if (project != null) {
return fromProjectNumber(project, id.get());
}
// Use the index to search for changes, but don't return any stored fields,
// to force rereading in case the index is stale.
InternalChangeQuery query = queryProvider.get().noFields();
List r = query.byLegacyChangeId(id);
if (r.size() == 1) {
changeIdProjectCache.put(id, Url.encode(r.get(0).project().get()));
}
return asChangeNotes(r);
}
private List asChangeNotes(List cds) throws OrmException {
List notes = new ArrayList<>(cds.size());
if (!indexConfig.separateChangeSubIndexes()) {
for (ChangeData cd : cds) {
notes.add(cd.notes());
}
return notes;
}
// If an index implementation uses separate non-atomic subindexes, it's possible to temporarily
// observe a change as present in both subindexes, if this search is concurrent with a write.
// Dedup to avoid confusing the caller. We can choose an arbitrary ChangeData instance because
// the index results have no stored fields, so the data is already reloaded. (It's also possible
// that a change might appear in zero subindexes, but there's nothing we can do here to help
// this case.)
Set seen = Sets.newHashSetWithExpectedSize(cds.size());
for (ChangeData cd : cds) {
if (seen.add(cd.getId())) {
notes.add(cd.notes());
}
}
return notes;
}
private void checkIdType(ChangeIdType type, boolean enforceDeprecation, String val)
throws DeprecatedIdentifierException {
if (enforceDeprecation
&& !allowedIdTypes.contains(ChangeIdType.ALL)
&& !allowedIdTypes.contains(type)) {
throw new DeprecatedIdentifierException(
String.format(
"The provided change identifier %s is deprecated. "
+ "Use 'project~changeNumber' instead.",
val));
}
changeIdCounter.increment(type);
}
}
