Establecer la vía de acceso de clases de construcción Java

Esta sección describe cómo establecer la vía de acceso de construcción Java, es decir, la vía de acceso de clases utilizada para crear un proyecto Java. Una vía de acceso de clases es una matriz de entradas de vía de acceso de clases que contabiliza los tipos disponibles en formato fuente o binario, que se utilizan para buscar los tipos disponibles. El orden de estas entradas define la preferencia de los tipos disponibles.

La vía de acceso de construcción Java también gobierna la estructura de un elemento de proyecto Java, ya que todas las raíces de fragmento de paquete se derivan directamente de la vía de acceso de construcción Java (cada entrada se correlaciona con una o más raíces de fragmento de paquete, consulte getPackageFragmentRoots).

Esta sección no describe la vía de acceso de ejecución Java que puede definirse por separado; consulte la sección relacionada acerca de cómo ejecutar programas Java.

Cambiar la vía de acceso de construcción

Puede cambiar programáticamente la vía de acceso de construcción de un proyecto mediante setRawClasspath en el elemento Java del proyecto correspondiente, como por ejemplo:

	IProject project = ... // obtener algún recurso de proyecto
	IJavaProject javaProject = JavaCore.create(project);
	IClasspathEntry[] newClasspath = ...;
	javaProject.setRawClasspath(newClasspath, someProgressMonitor);
	
Tenga en cuenta que también existe una variante de setRawClasspath que permite definir la vía de acceso de construcción Java y la ubicación de salida del proyecto simultáneamente.

La vía de acceso de construcción Java es persistente en un archivo denominado '.classpath' bajo la ubicación del proyecto. El propósito de este archivo es proporcionar una forma de compartir valores de vía de acceso de construcción Java con otros usuarios mediante algún depósito de código fuente. Específicamente, este archivo no debe editarse manualmente, ya que podría resultar dañado.

Entradas de vía de acceso de clases

Las entradas de vía de acceso de clases pueden definirse mediante métodos de fábrica definidos en JavaCore, para hacer referencia a cualquiera de los siguientes elementos:

Resolución de vía de acceso de clases

Debido a la presencia de entradas enlazadas dinámicamente (variables y contenedores de vía de acceso de clases), el núcleo de JDT efectúa una distinción entre una vía de acceso de clases original y una vía de acceso de clases resuelta. La cía de acceso de clases original es la que se estableció originalmente en el proyecto Java mediante setRawClasspath, y puede consultarse con mayor detalle solicitando getRawClasspath al proyecto.

También es posible consultar la vía de acceso de clases resuelta de un proyecto mediante getResolvedClasspath. Esta operación desencadena la inicialización de las variables y/o contenedores implicados si es necesario. Tenga en cuenta que muchas operaciones de Modelo Java provocan implícitamente la resolución de la vía de acceso de construcción Java; por ejemplo, el cálculo de raíces de fragmento de paquete de proyecto requiere resolver la vía de acceso de construcción.

 Copyright IBM Corporation y otros 2000, 2002. Reservados todos los derechos.