Package at.letto.image.restclient

Class RestImageService

java.lang.Object

at.letto.service.rest.RestClient

at.letto.image.restclient.RestImageService

All Implemented Interfaces:

ImageService, MicroService

public class RestImageService
extends RestClient
implements ImageService

Field Summary

Fields

Modifier and Type	Field	Description
(package private) String	serverpath
(package private) ImageServiceDto.SERVICEMODE	servicemode
(package private) String	tmpFilePath

Constructor Summary

Constructors

Constructor	Description
RestImageService(String baseURI, String user, String password, ImageServiceDto.SERVICEMODE servicemode, String tmpFilePath)

Method Summary

Modifier and Type	Method	Description
void	adaptUrlToRelative(String serverpath)	Anpassen des Image-Services an ein lokales Service: Die URL wird nicht mehr vollständig zurückgeben, sondern nur mehr ausgehend vom akt.
AdminInfoDto	admininfo()	Liefert Information über das Rest-Service
String	checkFilesystem()	Prüft ob das Service korrekt Daten im Filesystem speichern kann und gibt eine Fehlermeldung zurück wenn etwas nicht funktioniert oder einen Leerstring wenn Dateien korrekt gespeichert und gelesen werden können.
String	checkService()	Prüft die Funktionalität des Services und gibt eine Fehlermeldung zurück wenn etwas nicht funktioniert oder einen Leerstring wenn der Cache problemlos funktioniert.
boolean	createFile(String filename)	Erzeugt eine Datei mit dem angegebenen Dateinamen mit einer Dateigröße von null
boolean	delImage(String filename)	Löscht das Bild von der Festplatte
Vector<String>	delImages(Vector<String> images)	Löscht alle Dateien welche im Vektor angegeben sind
boolean	existImage(String filename)	Prüft ob ein Bild mit dem angegebenen Dateinamen schon existiert
String	getAbsURL(String filename)	Liefert die URL, mit der auf die Datei zugegriffen werden kann.
String	getExtension(String filename)	Liefert die Extension eines Dateinamens
long	getImageAge(String filename)	Liefert das Alter eines Bildes in Millisekunden
Vector<String>	getImages()	Liefert eine Liste aller Dateien, die im Image Cache gespeichert sind
long	getImageSize(String filename)	Liefert die Größe eines Bildes in Byte
Vector<String>	getImagesOlderThan(long age)	Liefert eine Liste aller Dateinamen der Dateien die älter als age ms sind
File	getLocalFile(String filename)	liefert ein File-Objekt, welches auf eine lokale Datei zeigt.
String	getURL(String filename)	Liefert die URL, mit der auf die Datei zugegriffen werden kann.
String	info()	Liefert einen allgemeinen Informationsstring zu dem Microservice
boolean	isFilenameOK(String filename)	prüft ob ein Dateiname den Bedingungen für die Dateinamen entspricht
String	loadImageBase64(String filename)	Lädt eine Datei als Base64 Codierte Datei aus dem Filesystem in eine Base64-codierten String
ImageBase64Dto	loadImageBase64Dto(String filename)	Lädt eine Datei als Base64 Codierte Datei aus dem Filesystem in eine Base64-codierten String
boolean	ping()	Schickt eine Ping an das Service
String	saveBase64Image(String base64encodedString, String extension)	Speichert eine Base-64-kodierte Datei
String	saveByteArrayImage(byte[] byteArray, String extension)	Speichert eine als Byte-Array vorliegende Datei
String	saveImage(ImageBase64Dto imageBase64Dto)	Speichert eine Base-64-kodierte Datei und sein zugehörigen Bild-Informationen
String	saveImage(BufferedImage image, String filename)	Speichert eine mit der AWT erzeugte Datei
String	saveImage(String base64File, String filename)	Speichert eine Base-64-kodierte Datei
String	saveLocalImage(File file)	Speichert eine lokale Datei im Image-Service
String	saveURLImage(String webPath)	Lädt eine Datei von einer URL und speichert sie im Image-Service unter der md5-Summe der Datei ab
String	version()	Liefert die Version des Microservices als String

Methods inherited from class at.letto.service.rest.RestClient

get, get, get, get, get, get, getDto, getHttpRestClient, getHttpRestClient, getHttpsRestClient, getHttpsRestClient, getRestClient, jsonTest, ping, ping, post, post, post, post, post, post, postDto, postDtoJson, postJson, rest, restGet, restGet, restPost, restPost

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

servicemode

ImageServiceDto.SERVICEMODE servicemode

tmpFilePath

String tmpFilePath

serverpath

String serverpath

Constructor Details

RestImageService

public RestImageService(String baseURI,
 String user,
 String password,
 ImageServiceDto.SERVICEMODE servicemode,
 String tmpFilePath)

Method Details

info

public String info()

Description copied from interface: MicroService

Liefert einen allgemeinen Informationsstring zu dem Microservice

Specified by:

info in interface MicroService

ping

public boolean ping()

Description copied from interface: MicroService

Schickt eine Ping an das Service

Specified by:

ping in interface MicroService

version

public String version()

Description copied from interface: MicroService

Liefert die Version des Microservices als String

Specified by:

version in interface MicroService

admininfo

public AdminInfoDto admininfo()

Description copied from interface: MicroService

Liefert Information über das Rest-Service

Specified by:

admininfo in interface MicroService

checkFilesystem

public String checkFilesystem()

Description copied from interface: ImageService

Prüft ob das Service korrekt Daten im Filesystem speichern kann und gibt eine Fehlermeldung zurück wenn etwas nicht funktioniert oder einen Leerstring wenn Dateien korrekt gespeichert und gelesen werden können.

Specified by:

checkFilesystem in interface ImageService

Returns:

Fehlermeldung oder Leerstring

checkService

public String checkService()

Description copied from interface: ImageService

Prüft die Funktionalität des Services und gibt eine Fehlermeldung zurück wenn etwas nicht funktioniert oder einen Leerstring wenn der Cache problemlos funktioniert.

Specified by:

checkService in interface ImageService

Returns:

Fehlermeldung oder Leerstring

existImage

public boolean existImage(String filename)

Description copied from interface: ImageService

Prüft ob ein Bild mit dem angegebenen Dateinamen schon existiert

Specified by:

existImage in interface ImageService

Parameters:

filename - Dateiname

Returns:

true wenn der Dateiname existiert

getImageAge

public long getImageAge(String filename)

Description copied from interface: ImageService

Liefert das Alter eines Bildes in Millisekunden

Specified by:

getImageAge in interface ImageService

Parameters:

filename - Dateiname

Returns:

Alter des Bildes in Millisekunden, -1 wenn das Bild nicht existiert, -2 wenn der filename ungültig ist

getImageSize

public long getImageSize(String filename)

Description copied from interface: ImageService

Liefert die Größe eines Bildes in Byte

Specified by:

getImageSize in interface ImageService

Parameters:

filename - Dateiname

Returns:

Größe des Bildes, -1 wenn das Bild nicht existiert, -2 wenn der filename ungültig ist

delImage

public boolean delImage(String filename)

Description copied from interface: ImageService

Löscht das Bild von der Festplatte

Specified by:

delImage in interface ImageService

Parameters:

filename - Dateiname

Returns:

true wenn das Bild gelöscht werden konnte

getURL

public String getURL(String filename)

Description copied from interface: ImageService

Liefert die URL, mit der auf die Datei zugegriffen werden kann.

Specified by:

getURL in interface ImageService

Parameters:

filename - Dateiname

Returns:

URL mit der auf die Datei zugegriffen werden kann, Leerstring wenn der filename nicht vorhanden ist

getAbsURL

public String getAbsURL(String filename)

Description copied from interface: ImageService

Liefert die URL, mit der auf die Datei zugegriffen werden kann.

Specified by:

getAbsURL in interface ImageService

Parameters:

filename - Dateiname

Returns:

URL mit der auf die Datei zugegriffen werden kann, Leerstring wenn der filename nicht vorhanden ist

createFile

public boolean createFile(String filename)

Description copied from interface: ImageService

Erzeugt eine Datei mit dem angegebenen Dateinamen mit einer Dateigröße von null

Specified by:

createFile in interface ImageService

Parameters:

filename - Dateiname

Returns:

true wenn die Datei erzeugt werden konnte

isFilenameOK

public boolean isFilenameOK(String filename)

Description copied from interface: ImageService

prüft ob ein Dateiname den Bedingungen für die Dateinamen entspricht

Specified by:

isFilenameOK in interface ImageService

Parameters:

filename - Dateiname

Returns:

true wenn der Dateiname gültig ist

getExtension

public String getExtension(String filename)

Description copied from interface: ImageService

Liefert die Extension eines Dateinamens

Specified by:

getExtension in interface ImageService

Parameters:

filename - Dateiname

Returns:

Extension

saveImage

public String saveImage(ImageBase64Dto imageBase64Dto)

Description copied from interface: ImageService

Speichert eine Base-64-kodierte Datei und sein zugehörigen Bild-Informationen

Specified by:

saveImage in interface ImageService

Parameters:

imageBase64Dto - Bild und Bild-Informationen

Returns:

Leer wenn ok, oder eine Fehlermeldung

loadImageBase64Dto

public ImageBase64Dto loadImageBase64Dto(String filename)

Description copied from interface: ImageService

Lädt eine Datei als Base64 Codierte Datei aus dem Filesystem in eine Base64-codierten String

Specified by:

loadImageBase64Dto in interface ImageService

Parameters:

filename - Dateiname der Datei die geladen werden soll

Returns:

Base64-codierter String des Dateiinhaltes

saveImage

public String saveImage(String base64File,
 String filename)

Description copied from interface: ImageService

Speichert eine Base-64-kodierte Datei

Specified by:

saveImage in interface ImageService

Parameters:

base64File - Dateiinhalt

filename - Dateiname

Returns:

Leer wenn ok, oder eine Fehlermeldung

saveImage

public String saveImage(BufferedImage image,
 String filename)

Description copied from interface: ImageService

Speichert eine mit der AWT erzeugte Datei

Specified by:

saveImage in interface ImageService

Parameters:

image - Dateiinhalt

filename - Dateiname unter dem die Datei gespeichert wird

Returns:

Leer wenn ok, oder eine Fehlermeldung

saveByteArrayImage

public String saveByteArrayImage(byte[] byteArray,
 String extension)

Description copied from interface: ImageService

Speichert eine als Byte-Array vorliegende Datei

Specified by:

saveByteArrayImage in interface ImageService

Parameters:

byteArray - Dateiinhalt

extension - Extension der Datei für den Dateityp

Returns:

Dateiname der gespeicherten Datei oder Leerstring bei einem Fehler

saveBase64Image

public String saveBase64Image(String base64encodedString,
 String extension)

Description copied from interface: ImageService

Speichert eine Base-64-kodierte Datei

Specified by:

saveBase64Image in interface ImageService

Parameters:

base64encodedString - Dateiinhalt

extension - Extension der Datei für den Dateityp

Returns:

Dateiname der gespeicherten Datei oder Leerstring bei einem Fehler

saveURLImage

public String saveURLImage(String webPath)

Description copied from interface: ImageService

Lädt eine Datei von einer URL und speichert sie im Image-Service unter der md5-Summe der Datei ab

Specified by:

saveURLImage in interface ImageService

Parameters:

webPath - URI der Datei welche gespeichert werden soll

Returns:

Dateiname der gespeicherten Datei oder Leerstring bei einem Fehler

saveLocalImage

public String saveLocalImage(File file)

Description copied from interface: ImageService

Speichert eine lokale Datei im Image-Service

Specified by:

saveLocalImage in interface ImageService

Parameters:

file - Datei

Returns:

Dateiname der gespeicherten Datei oder Leerstring bei einem Fehler

loadImageBase64

public String loadImageBase64(String filename)

Description copied from interface: ImageService

Lädt eine Datei als Base64 Codierte Datei aus dem Filesystem in eine Base64-codierten String

Specified by:

loadImageBase64 in interface ImageService

Parameters:

filename - Dateiname der Datei die geladen werden soll

Returns:

Base64-codierter String des Dateiinhaltes

getImages

public Vector<String> getImages()

Description copied from interface: ImageService

Liefert eine Liste aller Dateien, die im Image Cache gespeichert sind

Specified by:

getImages in interface ImageService

Returns:

Liste aller Dateinamen

delImages

public Vector<String> delImages(Vector<String> images)

Description copied from interface: ImageService

Löscht alle Dateien welche im Vektor angegeben sind

Specified by:

delImages in interface ImageService

Parameters:

images - Liste aller Dateinamen die gelöscht werden sollen

Returns:

Liste der gelöschten Dateinamen

getImagesOlderThan

public Vector<String> getImagesOlderThan(long age)

Description copied from interface: ImageService

Liefert eine Liste aller Dateinamen der Dateien die älter als age ms sind

Specified by:

getImagesOlderThan in interface ImageService

Parameters:

age - Alter in ms

Returns:

Liste aller Dateinamen der Dateien die älter als age ms sind

getLocalFile

public File getLocalFile(String filename)

Description copied from interface: ImageService

liefert ein File-Objekt, welches auf eine lokale Datei zeigt. Ist die Datei nicht lokal vorhanden wird sie lokal heruntergeladen und dann das File-Objekt zurückgegeben. Ist die Datei lokal vorhanden wird ein File-Objekt auf diese Datei zurückgegeben.

Specified by:

getLocalFile in interface ImageService

Parameters:

filename - Dateiname

Returns:

File-Objekt welches auf eine lokale Datei zeigt. Ist die Datei nicht vorhanden wird null zurückgegeben.

adaptUrlToRelative

public void adaptUrlToRelative(String serverpath)

Description copied from interface: ImageService

Anpassen des Image-Services an ein lokales Service: Die URL wird nicht mehr vollständig zurückgeben, sondern nur mehr ausgehend vom akt. Server beginnend mit zB. /images/....
Diese Anpassung wird nur durchgeführt, wenn das Image-Service und der Server die gleiche IP-Adresse und das gleiche port haben. Notwendig, um das Download-Attirbute im -Tag nutzen zu können

Specified by:

adaptUrlToRelative in interface ImageService

Parameters:

serverpath - Servlet-Path