¿Cuándo debería usar Import-Package y cuándo debería usar Require-Bundle?

Question

OSGi permite determinar dependencias a través de Import-Package, que simplemente conecta un paquete (exportado desde cualquier paquete) y Require-Bundle, que se conecta hasta las exportaciones de un determinado paquete nombrado.

Al construir una aplicación OSGi totalmente nueva, ¿qué enfoque debo usar para representar las dependencias? La mayoría de los paquetes serán internos, pero habrá algunas dependencias en paquetes externos (código abierto).

Answer 1

Creo que Require-Bundle es una cosa de Eclipse (que ahora ha sido incluida en la especificación OSGi para acomodar Eclipse). La forma "pura" de OSGi es usar Import-Package, ya que desacopla específicamente el paquete del paquete que lo proporciona. Debería declarar dependencias de la funcionalidad que necesita (la API de Java proporcionada por una determinada versión de un determinado paquete) en lugar de desde dónde proviene esa funcionalidad (lo cual no debería importarle). Esto mantiene la composición de los paquetes más flexible.

analogía de JavaScript: Esto es como detectar si un navegador web admite una determinada API, en vez de inferir de qué cadena de agente de usuario dice qué tipo de navegador es.

Peter Kriens de OSGi Alliance tiene más que decir sobre esto en el OSGi blog.

Probablemente el único caso en el que necesite utilizar Require-Bundle sea si tiene paquetes divididos, es decir, un paquete que se distribuye en múltiples paquetes. Los paquetes divididos son, por supuesto, muy desaconsejados.

Answer 2

Creo que Import-Package le da un acoplamiento más flexible y debe ser preferido. Lo uso cuando declaro dependencias en paquetes que no son de mi propiedad, como slf4j, y puedo intercambiar implementaciones como me gustaría. Utilizo Require-Bundle cuando la dependencia es algo sobre lo que tengo control, como mis propios paquetes, porque de todos modos cualquier cambio importante hubiera pasado por mí.

Answer 3

No estoy convencido de que usar Import-Package sea mejor, porque mi expectativa predeterminada cuando trabajo con un paquete es trabajar con la API pública asociada. Por esa razón, Require-Bundle tiene más sentido.

Answer 4

Favorece Importar-Paquete sobre Require-Bundle.

Require-Bundle:

• especifica el haz explícita (y versión) para su uso. Si un paquete requirde necesita ser refactorizado y un paquete trasladado a otro lugar, los dependientes necesitarán cambios en su MANIFEST.MF
• le da acceso a TODAS las exportaciones del paquete, independientemente de lo que sean, independientemente de si las necesita . Si las piezas que no necesitan tener sus propias dependencias tendrá que aquellos a
• paquetes pueden ser re-exportados
• aunque desanimado, permite el uso de paquetes divididos, es decir: un paquete que se transmite a través de múltiples paquetes
• se puede utilizar para dependencias sin código, por ejemplo: recursos, Ayuda, etc.

Import-Package:

• más flojo de acoplamiento, sólo el paquete (y versión) se especifica y el tiempo de ejecución se encuentra el paquete requerido
• implementaciones reales pueden swaped cabo
• Dependiente el propietario del paquete puede mover paquetes a diferentes paquetes
• Pero requiere que se mantengan más metadatos (es decir, cada nombre de paquete) en niveles más bajos de granularidad

Answer 5

Import-Package debería ser mejor, ya que, como se ha dicho anteriormente, puede mover un paquete de un paquete a otro sin cambiar MANIFIEST.MF de cliente existente

Pero ...

Hay una razón práctica para use Require-Bundle si está usando Eclipse para desarrollar sus paquetes:

Eclipse no usa paquetes como unidades de resolución. Utiliza paquetes. Es decir, si usa un paquete de un paquete, Eclipse compila su paquete sin informar ningún problema con el uso del resto de paquetes no importados de ese paquete.

Podría (usted es humano) pensar que todo está bien y cargar su paquete para la implementación pero ... su paquete se romperá en el tiempo de ejecución.

Estoy seguro porque este problema me ha sucedido (¡a mí!) Hoy.

La buena solución sería cambiar el contenedor Eclipse classpath, pero ... si esto no se va a hacer ... puede decidir evitar este tipo de problemas que requieren paquetes, en lugar de paquetes, pagando el precio mencionado (ningún movimiento de código compatible hacia atrás entre paquetes).

Answer 6

Avoid Import-Package. Como los paquetes proporcionan relaciones de muchos a muchos entre los paquetes, son propensos a ciclos de dependencia que son difíciles de detectar y evitar.

Require-Bundle, por otro lado, hace referencia a un solo paquete, haciendo que el gráfico de dependencia esté protegido de ciclos por una comprobación trivial de tiempo de compilación. Con Require-Bundle es mucho más fácil construir una arquitectura en capas con un nivel de abstracción aislado más bajo.