001/* 002 * Licensed to DuraSpace under one or more contributor license agreements. 003 * See the NOTICE file distributed with this work for additional information 004 * regarding copyright ownership. 005 * 006 * DuraSpace licenses this file to you under the Apache License, 007 * Version 2.0 (the "License"); you may not use this file except in 008 * compliance with the License. You may obtain a copy of the License at 009 * 010 * http://www.apache.org/licenses/LICENSE-2.0 011 * 012 * Unless required by applicable law or agreed to in writing, software 013 * distributed under the License is distributed on an "AS IS" BASIS, 014 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 015 * See the License for the specific language governing permissions and 016 * limitations under the License. 017 */ 018package org.fcrepo.kernel.api.services; 019 020import org.fcrepo.kernel.api.RdfStream; 021import org.fcrepo.kernel.api.exception.UnsupportedAlgorithmException; 022import org.fcrepo.kernel.api.models.Binary; 023 024import java.net.URI; 025import java.util.Collection; 026 027/** 028 * Service which calculates and compares digests for binary objects 029 * 030 * @author peichman 031 */ 032public interface FixityService { 033 /** 034 * Calculate the requested set of digests for the provided binary 035 * @param binary the binary resource to 036 * @param algorithms set of digest algorithms to calculate 037 * @return list of calculated digests 038 * @throws UnsupportedAlgorithmException if unsupported digest algorithms were provided 039 */ 040 Collection<URI> getFixity(Binary binary, Collection<String> algorithms) throws UnsupportedAlgorithmException; 041 042 /** 043 * Digest this binary with the digest algorithms provided 044 * @param binary the binary resource to digest 045 * @return The result of the fixity check. 046 */ 047 RdfStream checkFixity(Binary binary); 048}