org.nuiton.util
Class Resource

java.lang.Object
  org.nuiton.util.Resource

public class Resource
extends java.lang.Object

Cette class permet de rechercher un fichier en indiquant son nom avec son chemin. Cette librairie ira ensuite chercher ce fichier sur le système de fichier, et s'il n'est pas trouvé dans le classpath. Le fichier peut donc être dans un fichier .jar ou .zip.

Constructor Summary

protected

Resource()

Method Summary

static void	addClassLoader(java.lang.ClassLoader classLoader, java.net.URL url) Permet d'ajouter dans un classloader une nouvelle URL dans lequel il faut rechercher les fichiers.
static void	addDefaultClassLoader(java.net.URL url) Permet d'ajouter dans le classloader par defaut une nouvelle URL dans lequel il faut rechercher les fichiers.
static boolean	containsDirectDirectory(java.net.URL url, java.lang.String directory) Test if an url contains the given directory with no recurse seeking.
static java.net.URL[]	getClassPathURLsFromJarManifest(java.net.URL jarURL)
static java.util.Properties	getConfigProperties(java.lang.String filename) Deprecated. since 1.1.2, use ApplicationConfig class instead to ApplicationConfig.setConfigFileName(java.lang.String) and search properties file from more folders with ApplicationConfig.parse(java.lang.String[]) method
static java.util.Properties	getConfigProperties(java.lang.String filename, java.util.Properties parent) Deprecated. since 1.1.2, use ApplicationConfig class instead to ApplicationConfig.setConfigFileName(java.lang.String) and search properties file from more folders with ApplicationConfig.parse(java.lang.String[]) method
static javax.swing.ImageIcon	getIcon(java.lang.String name) Retourne l'icone demandee.
static java.lang.Class	getPrimitiveClass(java.lang.Class clazz) Retourne la classe du type primitf associé avec la classe de de l'objet passé en parametre.
static java.net.URL	getURL(java.lang.String name) Recherche la ressource nom.
static java.net.URL	getURLOrNull(java.lang.String name) Recherche la ressource nom.
static java.util.List<java.net.URL>	getURLs(java.lang.String pattern) Retourner la liste des fichiers du classLoader.
static java.util.List<java.net.URL>	getURLs(java.lang.String pattern, java.net.URL... arrayURL) Retourner la liste des fichiers du classLoader.
static java.util.List<java.net.URL>	getURLs(java.lang.String pattern, java.net.URLClassLoader classLoader) Retourner la liste des fichiers du classLoader.
static java.net.URL[]	getURLs(java.net.URLClassLoader classLoader) Deprecated. should use now ClassLoaderUtil.getURLs(java.net.URLClassLoader)
static java.util.List<java.net.URL>	getURLsFromDirectory(java.io.File repository, java.lang.String pattern) Retourne la liste des fichiers correspondant au pattern donne, aucun ordre ne doit être supposé sur les fichiers.
static java.util.List<java.net.URL>	getURLsFromJar(java.io.File jarfile, java.lang.String pattern)
static java.util.List<java.net.URL>	getURLsFromZip(java.io.File zipFile, java.lang.String pattern)
static boolean	isJar(java.lang.String name) Verifie si le fichier est un fichier jar.
static boolean	isPrimitive(java.lang.Class clazz) Verifie si la classe est de type primitif.
static boolean	isZip(java.lang.String name) Verifie si le fichier est un fichier zip

Methods inherited from class java.lang.Object

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

Constructor Detail

Resource

protected Resource()

Method Detail

addDefaultClassLoader

public static void addDefaultClassLoader(java.net.URL url)

Permet d'ajouter dans le classloader par defaut une nouvelle URL dans lequel il faut rechercher les fichiers.

Parameters:

url - l'url a ajouter

addClassLoader

public static void addClassLoader(java.lang.ClassLoader classLoader,
                                  java.net.URL url)

Permet d'ajouter dans un classloader une nouvelle URL dans lequel il faut rechercher les fichiers.

Parameters:

classLoader - le classloader a modifier

url - l'url a ajouter

getURL

public static java.net.URL getURL(java.lang.String name)

Recherche la ressource nom.

Parameters:

name - nom de la ressource

Returns:

l'url de la ressource

Throws:

ResourceNotFoundException - si la resource n'a pas ete trouvee

getURLOrNull

public static java.net.URL getURLOrNull(java.lang.String name)

Recherche la ressource nom.

Parameters:

name - le nom de la ressource

Returns:

l'url de la ressource ou null

getIcon

public static javax.swing.ImageIcon getIcon(java.lang.String name)

Retourne l'icone demandee.

Parameters:

name - le nom de l'icone

Returns:

Retourne l'icon demande ou null s'il n'est pas trouvé

getConfigProperties

@Deprecated
public static java.util.Properties getConfigProperties(java.lang.String filename)
                                                throws java.io.IOException

Deprecated. since 1.1.2, use ApplicationConfig class instead to ApplicationConfig.setConfigFileName(java.lang.String) and search properties file from more folders with ApplicationConfig.parse(java.lang.String[]) method

Recherche et retourne l'objet properties de configuration à utiliser.

Les différents fichiers trouvé sont chainé. L'ordre de recherche est le classpath, le fichier dans /etc et enfin le chemin sur le filesystem.

Parameters:

filename - le nom du fichier à rechercher

Returns:

l'objet Properties de configuration

Throws:

java.io.IOException - si une erreur est survenue

getConfigProperties

@Deprecated
public static java.util.Properties getConfigProperties(java.lang.String filename,
                                                                  java.util.Properties parent)
                                                throws java.io.IOException

Deprecated. since 1.1.2, use ApplicationConfig class instead to ApplicationConfig.setConfigFileName(java.lang.String) and search properties file from more folders with ApplicationConfig.parse(java.lang.String[]) method

Recherche et retourne l'objet properties de configuration à utiliser.

Les différents fichiers trouvé sont chainé. L'ordre de recherche est le classpath, le fichier dans /etc et enfin le chemin sur le filesystem.

Parameters:

filename - le nom du fichier à rechercher

parent - les proprietes parent a surcharger

Returns:

l'objet Properties de configuration

Throws:

java.io.IOException - si une erreur est survenue

getURLs

public static java.util.List<java.net.URL> getURLs(java.lang.String pattern)

Retourner la liste des fichiers du classLoader. Ces fichiers doivent correspondre au pattern donne.

Parameters:

pattern - le nom du fichier a extraire du fichier compressé ou du repertoire doit correspondre au pattern (repertoire + nom compris).

Returns:

la liste des urls correspondant au pattern

getURLs

public static java.net.URL[] getURLs(java.net.URLClassLoader classLoader)

Deprecated. should use now ClassLoaderUtil.getURLs(java.net.URLClassLoader)

Recupere la liste des urls d'un URLClassLoader.

Note : Un cas particulier est positionné pour JBoss qui utilise la method getAllURLs.

Parameters:

classLoader - le class loader a scanner

Returns:

les urls du classloade.

getURLs

public static java.util.List<java.net.URL> getURLs(java.lang.String pattern,
                                                   java.net.URLClassLoader classLoader)

Retourner la liste des fichiers du classLoader. Ces fichiers doivent correspondre au pattern donne.

Parameters:

classLoader - le classLoader

pattern - le nom du fichier a extraire du fichier compressé ou du repertoire doit correspondre au pattern (repertoire + nom compris).

Returns:

la liste des urls correspondant au pattern

getURLs

public static java.util.List<java.net.URL> getURLs(java.lang.String pattern,
                                                   java.net.URL... arrayURL)

Retourner la liste des fichiers du classLoader. Ces fichiers doivent correspondre au pattern donne.

Parameters:

arrayURL - les urls ou chercher

pattern - le nom du fichier a extraire du fichier compressé ou durepertoire doit correspondre au pattern (repertoire + nom compris).

Returns:

la liste des urls correspondant au pattern

getClassPathURLsFromJarManifest

public static java.net.URL[] getClassPathURLsFromJarManifest(java.net.URL jarURL)
                                                      throws java.io.IOException,
                                                             java.net.URISyntaxException

Throws:

java.io.IOException

java.net.URISyntaxException

getURLsFromZip

public static java.util.List<java.net.URL> getURLsFromZip(java.io.File zipFile,
                                                          java.lang.String pattern)

getURLsFromJar

public static java.util.List<java.net.URL> getURLsFromJar(java.io.File jarfile,
                                                          java.lang.String pattern)

getURLsFromDirectory

public static java.util.List<java.net.URL> getURLsFromDirectory(java.io.File repository,
                                                                java.lang.String pattern)

Retourne la liste des fichiers correspondant au pattern donne, aucun ordre ne doit être supposé sur les fichiers.

Parameters:

repository - repertoire dans lequel on recherche les fichiers

pattern - le nom du fichier a extraire du fichier du repertoire doit correspondre au pattern (repertoire + nom compris). si le pattern est null, tous les fichiers trouvé sont retourné.

Returns:

la liste des urls correspondant au pattern

isJar

public static boolean isJar(java.lang.String name)

Verifie si le fichier est un fichier jar.

Parameters:

name - nom du fichier a tester

Returns:

vrai si le fichier se termine par .jar faux sinon

isZip

public static boolean isZip(java.lang.String name)

Verifie si le fichier est un fichier zip

Parameters:

name - nom du fichier a tester

Returns:

vrai si le fichier se termine par .zip faux sinon

isPrimitive

public static boolean isPrimitive(java.lang.Class clazz)

Verifie si la classe est de type primitif.

Parameters:

clazz - nom de la classe a tester

Returns:

vrai si le classe est de type primitif faux sinon

getPrimitiveClass

public static java.lang.Class getPrimitiveClass(java.lang.Class clazz)

Retourne la classe du type primitf associé avec la classe de de l'objet passé en parametre. Par exemple si la classe passée en paramètre est Integer alors le resultat sera la classe de int.

Parameters:

clazz - la classe dont on souhaite le type primitf

Returns:

le type primitif associé a la classe en paramètre, ou null s'il n'y a pas de type primitif associé.

containsDirectDirectory

public static boolean containsDirectDirectory(java.net.URL url,
                                              java.lang.String directory)
                                       throws java.io.IOException

Test if an url contains the given directory with no recurse seeking.

Parameters:

url - the url to seek

directory - the directory to find

Returns:

true if directory was found, false otherwise.

Throws:

java.io.IOException - if any io pb