ClassLoader Classe

Définition

[Android.Runtime.Register("java/lang/ClassLoader", DoNotGenerateAcw=true)]
public abstract class ClassLoader : Java.Lang.Object

[<Android.Runtime.Register("java/lang/ClassLoader", DoNotGenerateAcw=true)>]
type ClassLoader = class
    inherit Object

Héritage

Object

JavaObject

Object

ClassLoader

Dérivé

Dalvik.SystemInterop.BaseDexClassLoader

Java.Security.SecureClassLoader

Attributs

RegisterAttribute

Remarques

Un chargeur de classes est un objet responsable du chargement des classes. La classe est une classe ClassLoader abstraite. Étant donné le nom binaire d’une classe, un chargeur de classes doit tenter de localiser ou de générer des données qui constituent une définition pour la classe. Une stratégie classique consiste à transformer le nom en nom de fichier, puis à lire un « fichier de classe » de ce nom à partir d’un système de fichiers.

Chaque java.lang.Class Class objet contient un Class#getClassLoader() reference objet qui l’a ClassLoader défini.

Classles objets pour les classes de tableau ne sont pas créés par les chargeurs de classes, mais sont créés automatiquement comme requis par le runtime Java. Le chargeur de classes pour une classe de tableau, tel qu’il est retourné par Class#getClassLoader() est le même que le chargeur de classes pour son type d’élément ; si le type d’élément est un type primitif, la classe de tableau n’a pas de chargeur de classe.

Les applications implémentent des sous-classes pour ClassLoader étendre la manière dont la machine virtuelle Java charge dynamiquement les classes.

Les chargeurs de classes peuvent généralement être utilisés par les gestionnaires de sécurité pour indiquer des domaines de sécurité.

Outre le chargement de classes, un chargeur de classes est également responsable de la localisation des ressources. Une ressource est une ressource (un fichier «.class », des données de configuration ou une image par exemple) identifiées avec un nom de chemin d’accès abstrait « / ». Les ressources sont généralement empaquetées avec une application ou une bibliothèque afin qu’elles puissent être situées par code dans l’application ou la bibliothèque. Dans certains cas, les ressources sont incluses afin qu’elles puissent être localisées par d’autres bibliothèques.

La ClassLoader classe utilise un modèle de délégation pour rechercher des classes et des ressources. Chaque instance d’un chargeur de ClassLoader classe parent associé. Lorsqu’elle est demandée pour rechercher une classe ou une ressource, une ClassLoader instance délègue généralement la recherche de la classe ou de la ressource à son chargeur de classes parent avant de tenter de trouver la classe ou la ressource elle-même.

Les chargeurs de classes qui prennent en charge le chargement simultané de classes sont appelés <chargeurs de classes em>#isRegisteredAsParallelCapable() parallel capable</em> et doivent s’inscrire à leur heure d’initialisation de classe en appelant la #registerAsParallelCapable ClassLoader.registerAsParallelCapable méthode. Notez que la ClassLoader classe est inscrite en tant que capacité parallèle par défaut. Toutefois, ses sous-classes doivent toujours s’inscrire s’ils sont en mesure d’être parallèles. Dans les environnements dans lesquels le modèle de délégation n’est pas strictement hiérarchique, les chargeurs de classes doivent être compatibles parallèlement, sinon le chargement de classes peut entraîner des blocages, car le verrou du chargeur est conservé pendant la durée du processus de chargement de classe (voir #loadClass loadClass les méthodes).

<h2> « builtinLoaders">Run-time Built-in Class Loaders</h2>

Le Java runtime a les chargeurs de classes intégrés suivants :

<ul><li>

Chargeur de classe Bootstrap. Il s’agit du chargeur de classes intégré de la machine virtuelle, généralement représenté comme null, et n’a pas de parent.</li li><>

chargeur de classe système #getSystemClassLoader(). Il est également appelé <>chargeur< de classe d’application em> et est distinct du chargeur de classe de plateforme. Le chargeur de classes système est généralement utilisé pour définir des classes sur le chemin de la classe d’application, le chemin d’accès du module et les outils spécifiques à JDK. Le chargeur de classe de plateforme est le parent ou un ancêtre du chargeur de classe système, de sorte que le chargeur de classe système peut charger des classes de plateforme en déléguant à son parent.</li></ul>

Normalement, la machine virtuelle Java charge les classes à partir du système de fichiers local de manière dépendante de la plateforme. Toutefois, certaines classes peuvent ne pas provenir d’un fichier ; ils peuvent provenir d’autres sources, telles que le réseau, ou ils peuvent être construits par une application. La méthode #defineClass(String, byte[], int, int) defineClass convertit un tableau d’octets en une instance de classe Class. Les instances de cette classe nouvellement définie peuvent être créées à l’aide Class#newInstance Class.newInstancede .

Les méthodes et les constructeurs d’objets créés par un chargeur de classes peuvent référencer d’autres classes. Pour déterminer la ou les classes référencées, la machine virtuelle Java appelle la #loadClass loadClass méthode du chargeur de classes qui a créé la classe à l’origine.

Par exemple, une application peut créer un chargeur de classes réseau pour télécharger des fichiers de classe à partir d’un serveur. L’exemple de code peut ressembler à ceci :

<blockquote>

ClassLoader loader = new NetworkClassLoader(host, port);
              Object main = loader.loadClass("Main", true).newInstance();
                   . . .

</blockquote>

La sous-classe du chargeur de classe réseau doit définir les méthodes #findClass findClass et loadClassData charger une classe à partir du réseau. Une fois qu’il a téléchargé les octets qui composent la classe, il doit utiliser la méthode #defineClass defineClass pour créer une instance de classe. Un exemple d’implémentation est :

<blockquote>

class NetworkClassLoader extends ClassLoader {
                    String host;
                    int port;

                    public Class findClass(String name) {
                        byte[] b = loadClassData(name);
                        return defineClass(name, b, 0, b.length);
                    }

                    private byte[] loadClassData(String name) {
                        // load the class data from the connection
                         . . .
                    }
                }

</blockquote>

<h3> « binary-name">Binary names</h3>

Tout nom de classe fourni en tant que String paramètre pour les méthodes doit ClassLoader être un nom binaire tel que défini par <la citation>La spécification</cite> du langage Java.

Voici quelques exemples de noms de classes valides : <blockquote>

"java.lang.String"
              "javax.swing.JSpinner$DefaultEditor"
              "java.security.KeyStore$Builder$FileBuilder$1"
              "java.net.URLClassLoader$3$1"

</blockquote>

Tout nom de package fourni en tant que String paramètre pour les méthodes doit ClassLoader être la chaîne vide (indiquant un package sans nom) ou un nom complet tel qu’il est défini par <cite>The Java Language Specification</cite>.

Ajouté dans la version 1.0.

Java documentation pour java.lang.ClassLoader.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.