001package ca.uhn.fhir.rest.gclient;
002
003/*
004 * #%L
005 * HAPI FHIR - Core Library
006 * %%
007 * Copyright (C) 2014 - 2021 Smile CDR, Inc.
008 * %%
009 * Licensed under the Apache License, Version 2.0 (the "License");
010 * you may not use this file except in compliance with the License.
011 * You may obtain a copy of the License at
012 *
013 *      http://www.apache.org/licenses/LICENSE-2.0
014 *
015 * Unless required by applicable law or agreed to in writing, software
016 * distributed under the License is distributed on an "AS IS" BASIS,
017 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
018 * See the License for the specific language governing permissions and
019 * limitations under the License.
020 * #L%
021 */
022
023import org.hl7.fhir.instance.model.api.IBaseResource;
024
025import ca.uhn.fhir.rest.server.exceptions.NotModifiedException;
026
027public interface IReadIfNoneMatch<T extends IBaseResource> {
028
029        /**
030         * If the server responds with an <code>HTTP 301 Not Modified</code>,
031         * return the given instance.
032         */
033        IReadExecutable<T> returnResource(T theInstance);
034        
035        /**
036         * If the server responds with an <code>HTTP 301 Not Modified</code>,
037         * return <code>null</code>.
038         */
039        IReadExecutable<T> returnNull();
040        
041        /**
042         * If the server responds with an <code>HTTP 301 Not Modified</code>,
043         * throw a {@link NotModifiedException}.
044         */
045        IReadExecutable<T> throwNotModifiedException();
046        
047}