de.fraunhofer.igd.klarschiff.service.image

Class ImageService

java.lang.Object

de.fraunhofer.igd.klarschiff.service.image.ImageService

@Service
public class ImageService
extends Object

Der Service dient zur Manipulation von Bildern, wie z.B. das Skalieren oder das Ausschwärzen von Bildbereichen, bzw. zum Auslesen eines Bildes aus einem HTTP-Request

Author:

Stefan Audersch (Fraunhofer IGD), Marcus Kröller (Fraunhofer IGD), Alexander Kruth (BFPI)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ImageService.ScaleTyp Gibt an, wie ein Bild skaliert werden soll.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) int	fotoGrossHeight
(package private) int	fotoGrossWidth
(package private) int	fotoNormalHeight
(package private) int	fotoNormalWidth
(package private) int	fotoThumbHeight
(package private) int	fotoThumbWidth
(package private) ImageService.ScaleTyp	scaleTyp
(package private) SettingsService	settingsService

Constructor Summary

Constructors

Constructor and Description
ImageService()

Method Summary

Modifier and Type	Method and Description
void	censorImageForVorgang(Vorgang vorgang, String rectangles, Integer width, Integer height) Schwarz Bereiche in einem Bild aus.
String	generateFilenameAndWriteFileForFoto(byte[] image, Foto foto, String prevFilename, String middlePart) Speichert das in image übergebene Bild im Dateisystem.
String	generateFilenameAndWriteFileForVorgang(byte[] image, Vorgang vorgang, String prevFilename, String middlePart) Speichert das in image übergebene Bild im Dateisystem.
String	generateFilenameAndWriteFileWithPrefix(byte[] image, String prefix, String prevFilename, String middlePart) Speichert das in image übergebene Bild in den Dateinamen, der über prevFilename übergeben wurde.
int	getFotoNormalHeight()
int	getFotoNormalWidth()
int	getFotoThumbHeight()
int	getFotoThumbWidth()
String	getPath()
ImageService.ScaleTyp	getScaleTyp()
String	getUrl()
BufferedImage	imageFromVorgang(Vorgang vorgang) Setzt das Bild für einen Vorgang.
private static byte[]	imageToByteArray(BufferedImage image) Erzeugt aus einem Bild als BufferedImage ein ByteArray (JPEG)
private BufferedImage	rotateImage(BufferedImage oldImage, double degrees) Rotiert das Bild übergebene Bild um die Grad, die ebenfalls übergeben werden.
void	rotateImageForVorgang(Vorgang vorgang) Rotiert das Bild um 90 Grad im Uhrzeigersinn und legt es im Dateisystem wieder ab.
static byte[]	scaleImage(byte[] image, Integer width, Integer height, ImageService.ScaleTyp scaleTyp) Scalliert ein Bild.
void	setFotoNormalHeight(int fotoNormalHeight)
void	setFotoNormalWidth(int fotoNormalWidth)
void	setFotoThumbHeight(int fotoThumbHeight)
void	setFotoThumbWidth(int fotoThumbWidth)
void	setImageForFoto(byte[] image, Foto foto) Setzt das Bild für eine Foto.
void	setImageForVorgang(byte[] image, Vorgang vorgang) Setzt das Bild für einen Vorgang.
void	setImageForVorgang(org.springframework.web.multipart.MultipartFile multipartFile, Vorgang vorgang) Setzt das Foto (Vorschau und eigentliches Bild) für einen Vorgang.
void	setImageForVorgangOrFoto(byte[] image, Vorgang vorgang, Foto foto) Setzt das Bild für einen Vorgang oder ein Foto.
void	setScaleTyp(ImageService.ScaleTyp scaleTyp)

Methods inherited from class java.lang.Object

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

Field Detail

settingsService

@Autowired
SettingsService settingsService

fotoGrossWidth

int fotoGrossWidth

fotoGrossHeight

int fotoGrossHeight

fotoNormalWidth

int fotoNormalWidth

fotoNormalHeight

int fotoNormalHeight

fotoThumbWidth

int fotoThumbWidth

fotoThumbHeight

int fotoThumbHeight

scaleTyp

ImageService.ScaleTyp scaleTyp

Constructor Detail

ImageService

public ImageService()

Method Detail

setImageForVorgang

public void setImageForVorgang(byte[] image,
                               Vorgang vorgang)
                        throws Exception

Setzt das Bild für einen Vorgang.

Parameters:

image - Bild als ByteArray

vorgang - Vorgang in dem die Bilddaten gesetzt werden sollen

Throws:

Exception

setImageForFoto

public void setImageForFoto(byte[] image,
                            Foto foto)
                     throws Exception

Setzt das Bild für eine Foto.

Parameters:

image - Bild als ByteArray

foto - Foto in dem die Bilddaten gesetzt werden sollen

Throws:

Exception

setImageForVorgangOrFoto

public void setImageForVorgangOrFoto(byte[] image,
                                     Vorgang vorgang,
                                     Foto foto)
                              throws Exception

Setzt das Bild für einen Vorgang oder ein Foto. Dabei wird das Bild in drei Größen abgelegt (Gross, Normal, Thumb). Die Bilder werden entsprechend skaliert.

Parameters:

image - Bild als ByteArray

vorgang - Vorgang in dem die Bilddaten gesetzt werden sollen

Throws:

Exception

generateFilenameAndWriteFileForVorgang

public String generateFilenameAndWriteFileForVorgang(byte[] image,
                                                     Vorgang vorgang,
                                                     String prevFilename,
                                                     String middlePart)
                                              throws IOException

Speichert das in image übergebene Bild im Dateisystem.

Parameters:

image - Bilddaten

vorgang - Vorgang

prevFilename - Dateiname, darf leer sein

middlePart - Zum Erzeugen eines neuen Dateinamens

Returns:

neuer oder übergebener Dateiname

Throws:

IOException

generateFilenameAndWriteFileForFoto

public String generateFilenameAndWriteFileForFoto(byte[] image,
                                                  Foto foto,
                                                  String prevFilename,
                                                  String middlePart)
                                           throws IOException

Speichert das in image übergebene Bild im Dateisystem.

Parameters:

image - Bilddaten

foto - Foto

prevFilename - Dateiname, darf leer sein

middlePart - Zum Erzeugen eines neuen Dateinamens

Returns:

neuer oder übergebener Dateiname

Throws:

IOException

generateFilenameAndWriteFileWithPrefix

public String generateFilenameAndWriteFileWithPrefix(byte[] image,
                                                     String prefix,
                                                     String prevFilename,
                                                     String middlePart)
                                              throws IOException

Speichert das in image übergebene Bild in den Dateinamen, der über prevFilename übergeben wurde. Falls dieser leer ist, wird mittels vorgang-ID und middlePart und einer UUID ein neuer Dateiname generiert und zurück gegeben.

Parameters:

image - Bilddaten

prefix - Prefix für Dateiname

prevFilename - Dateiname, darf leer sein

middlePart - Zum Erzeugen eines neuen Dateinamens

Returns:

neuer oder übergebener Dateiname

Throws:

IOException

imageFromVorgang

public BufferedImage imageFromVorgang(Vorgang vorgang)
                               throws IOException

Setzt das Bild für einen Vorgang. Dabei wird das Bild in drei Größen abgelegt (Gross, Normal, Thumb). Die Bilder werden entsprechend skaliert.

Parameters:

vorgang - Vorgang von dem die Bilddaten geholt werden sollen

Returns:

Bilddaten als BufferedImage

Throws:

IOException

censorImageForVorgang

public void censorImageForVorgang(Vorgang vorgang,
                                  String rectangles,
                                  Integer width,
                                  Integer height)

Schwarz Bereiche in einem Bild aus. Das Vorschau- als auch das eigentliche Bild eines Vorganges wird dabei geändert.

Parameters:

vorgang - Vorgang, bei dem Bereiche aus dem Bild geschwarzt werden sollen

rectangles - Liste von Rechtecken als String, die für die Schwarzung verwendet werden sollen

width - relative Höhe, die bei der Erstellung der Rechtecke verwendet wurde

height - relative Breite, die bei der Erstellung der rechtecke verwendet wurde

rotateImageForVorgang

public void rotateImageForVorgang(Vorgang vorgang)

Rotiert das Bild um 90 Grad im Uhrzeigersinn und legt es im Dateisystem wieder ab.

Parameters:

vorgang - Vorgang, bei dem das Bild gedreht werden sollen

rotateImage

private BufferedImage rotateImage(BufferedImage oldImage,
                                  double degrees)

Rotiert das Bild übergebene Bild um die Grad, die ebenfalls übergeben werden.

Parameters:

oldImage - Original-Bilddaten als BufferedImage

degrees - Grad um die das Bild gedreht werden soll

Returns:

Gedrehtes Bild als BufferedImage

setImageForVorgang

public void setImageForVorgang(org.springframework.web.multipart.MultipartFile multipartFile,
                               Vorgang vorgang)
                        throws Exception

Setzt das Foto (Vorschau und eigentliches Bild) für einen Vorgang.

Parameters:

multipartFile - Teil des HTTP-Requestes mit den Bilddaten

vorgang - Vorgang bei dem das foto gesetzt werden soll

Throws:

Exception

scaleImage

public static byte[] scaleImage(byte[] image,
                                Integer width,
                                Integer height,
                                ImageService.ScaleTyp scaleTyp)
                         throws Exception

Scalliert ein Bild. Dabei kann über den ScaleType angegeben werden, ob das Ergebnisbild die entsprechenden maximalen Abmaße haben soll, oder das Ergebnisbild genau die Abmaße haben soll, wobei entsprechende Teile des Bildes dann transparent gemacht werden sollen.

Parameters:

image - Bild als ByteArray, welches scaliert werden soll

width - Breite bzw. maximale Breite des Ergebnisbild

height - Höhe bzw. maximale Höhe des Ergebnisbildes

scaleTyp - Typ der Transfomation

Returns:

scalliertes Bild als ByteArray

Throws:

Exception

imageToByteArray

private static byte[] imageToByteArray(BufferedImage image)
                                throws IOException

Erzeugt aus einem Bild als BufferedImage ein ByteArray (JPEG)

Parameters:

image - Bild, welches in ein ByteArray transformiert werden soll

Returns:

ByteArray (JPEG) des Bildes

Throws:

IOException

getFotoNormalWidth

public int getFotoNormalWidth()

setFotoNormalWidth

public void setFotoNormalWidth(int fotoNormalWidth)

getFotoNormalHeight

public int getFotoNormalHeight()

setFotoNormalHeight

public void setFotoNormalHeight(int fotoNormalHeight)

getFotoThumbWidth

public int getFotoThumbWidth()

setFotoThumbWidth

public void setFotoThumbWidth(int fotoThumbWidth)

getFotoThumbHeight

public int getFotoThumbHeight()

setFotoThumbHeight

public void setFotoThumbHeight(int fotoThumbHeight)

getScaleTyp

public ImageService.ScaleTyp getScaleTyp()

setScaleTyp

public void setScaleTyp(ImageService.ScaleTyp scaleTyp)

getPath

public String getPath()

getUrl

public String getUrl()