no.digipost.api.client.delivery.OngoingDelivery Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of digipost-api-client-java Show documentation
${project.artifactId}
The newest version!
/**
 * Copyright (C) Posten Norge AS
 *
 * 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 no.digipost.api.client.delivery;

import no.digipost.api.client.DigipostClient;
import no.digipost.api.client.representations.Document;
import no.digipost.api.client.representations.MessageDelivery;

import java.io.InputStream;


/**
 * Operasjoner for å fullføre leveranse av en forsendelse. En forsendelse
 * kan enten være {@link WithPrintFallback til Digipost-mottakere} eller
 * sendes {@link ForPrintOnly direkte til print}.
 *
 * @param  Type som har et gyldig sett med operasjoner for denne
 *                     forsendelsen. Enten {@link SendableWithPrintFallback}
 *                     eller {@link SendableForPrintOnly}.
 *
 * @see WithPrintFallback
 * @see ForPrintOnly
 * @see DigipostClient#createMessage(no.digipost.api.client.representations.Message)
 * @see DigipostClient#createPrintOnlyMessage(no.digipost.api.client.representations.Message)
 */
public interface OngoingDelivery & OngoingDelivery.SendableDelivery> {


	/**
	 * Laster opp innhold til et dokument.
	 */
	OPERATIONS addContent(Document document, InputStream content);



	/**
	 * Operasjoner for å sende forsendelser direkte til print.
	 * Alt dokumentinnhold i forsendelsen må være PDF.
	 */
	public static interface ForPrintOnly extends OngoingDelivery {
	}



	/**
	 * Operasjoner for å sende forsendelser til Digipost, men mulig fallback til print
	 * dersom avsender har egnet avtale for dette.
	 */
	public static interface WithPrintFallback extends OngoingDelivery {

		/**
		 * Laster opp innhold til et dokument med alternativt innhold for print (må være PDF).
		 *
		 * @return videre operasjoner for å fullføre leveransen.
		 */
		SendableWithPrintFallback addContent(Document document, InputStream content, InputStream printContent);
	}



	public static interface SendableDelivery {
		/**
		 * Sender forsendelsen.
		 */
		MessageDelivery send();
	}

	public static interface SendableForPrintOnly extends SendableDelivery, ForPrintOnly { }

	public static interface SendableWithPrintFallback extends SendableDelivery, WithPrintFallback { }

}