org.apache.solr.handler.admin.api.CoreReplicationAPI Maven / Gradle / Ivy
Show all versions of solr-core Show documentation
/*
* 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.solr.handler.admin.api;
import static org.apache.solr.client.solrj.impl.BinaryResponseParser.BINARY_CONTENT_TYPE_V2;
import static org.apache.solr.security.PermissionNameProvider.Name.CORE_READ_PERM;
import com.fasterxml.jackson.annotation.JsonProperty;
import io.swagger.v3.oas.annotations.Parameter;
import jakarta.inject.Inject;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.QueryParam;
import jakarta.ws.rs.core.MediaType;
import java.io.IOException;
import java.util.List;
import org.apache.solr.client.api.model.SolrJerseyResponse;
import org.apache.solr.core.SolrCore;
import org.apache.solr.jersey.JacksonReflectMapWriter;
import org.apache.solr.jersey.PermissionName;
import org.apache.solr.request.SolrQueryRequest;
import org.apache.solr.response.SolrQueryResponse;
/**
* V2 APIs for inspecting and replicating indices
*
* These APIs are analogous to the v1 /coreName/replication APIs.
*/
@Path("/cores/{coreName}/replication")
public class CoreReplicationAPI extends ReplicationAPIBase {
@Inject
public CoreReplicationAPI(SolrCore solrCore, SolrQueryRequest req, SolrQueryResponse rsp) {
super(solrCore, req, rsp);
}
@GET
@Path("/indexversion")
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML, BINARY_CONTENT_TYPE_V2})
@PermissionName(CORE_READ_PERM)
public IndexVersionResponse fetchIndexVersion() throws IOException {
return doFetchIndexVersion();
}
@GET
@Path("/files")
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML, BINARY_CONTENT_TYPE_V2})
@PermissionName(CORE_READ_PERM)
public FileListResponse fetchFileList(
@Parameter(description = "The generation number of the index", required = true)
@QueryParam("generation")
long gen) {
return doFetchFileList(gen);
}
/** Response for {@link CoreReplicationAPI#fetchIndexVersion()}. */
public static class IndexVersionResponse extends SolrJerseyResponse {
@JsonProperty("indexversion")
public Long indexVersion;
@JsonProperty("generation")
public Long generation;
@JsonProperty("status")
public String status;
public IndexVersionResponse() {}
public IndexVersionResponse(Long indexVersion, Long generation, String status) {
this.indexVersion = indexVersion;
this.generation = generation;
this.status = status;
}
}
/** Response for {@link CoreReplicationAPI#fetchFileList(long)}. */
public static class FileListResponse extends SolrJerseyResponse {
@JsonProperty("filelist")
public List fileList;
@JsonProperty("confFiles")
public List confFiles;
@JsonProperty("status")
public String status;
@JsonProperty("message")
public String message;
@JsonProperty("exception")
public Exception exception;
public FileListResponse() {}
}
/**
* Contained in {@link CoreReplicationAPI.FileListResponse}, this holds metadata from a file for
* an index
*/
public static class FileMetaData implements JacksonReflectMapWriter {
@JsonProperty("size")
public long size;
@JsonProperty("name")
public String name;
@JsonProperty("checksum")
public long checksum;
@JsonProperty("alias")
public String alias;
public FileMetaData() {}
public FileMetaData(long size, String name, long checksum) {
this.size = size;
this.name = name;
this.checksum = checksum;
}
}
}