Lucene JBoss Modules parent

Distribution of Lucene packaged into JBoss Modules

License

License

Categories

Categories

JBoss Container Application Servers Hibernate Data ORM
GroupId

GroupId

org.hibernate.lucene-jbossmodules
ArtifactId

ArtifactId

lucene-jbossmodules-parent
Last Version

Last Version

5.5.5.hibernate06
Release Date

Release Date

Type

Type

pom
Description

Description

Lucene JBoss Modules parent
Distribution of Lucene packaged into JBoss Modules
Project URL

Project URL

https://github.com/hibernate/lucene-jbossmodules
Project Organization

Project Organization

Hibernate
Source Code Management

Source Code Management

http://github.com/hibernate/lucene-jbossmodules

Download lucene-jbossmodules-parent

How to add to project

<!-- https://jarcasting.com/artifacts/org.hibernate.lucene-jbossmodules/lucene-jbossmodules-parent/ -->
<dependency>
    <groupId>org.hibernate.lucene-jbossmodules</groupId>
    <artifactId>lucene-jbossmodules-parent</artifactId>
    <version>5.5.5.hibernate06</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/org.hibernate.lucene-jbossmodules/lucene-jbossmodules-parent/
implementation 'org.hibernate.lucene-jbossmodules:lucene-jbossmodules-parent:5.5.5.hibernate06'
// https://jarcasting.com/artifacts/org.hibernate.lucene-jbossmodules/lucene-jbossmodules-parent/
implementation ("org.hibernate.lucene-jbossmodules:lucene-jbossmodules-parent:5.5.5.hibernate06")
'org.hibernate.lucene-jbossmodules:lucene-jbossmodules-parent:pom:5.5.5.hibernate06'
<dependency org="org.hibernate.lucene-jbossmodules" name="lucene-jbossmodules-parent" rev="5.5.5.hibernate06">
  <artifact name="lucene-jbossmodules-parent" type="pom" />
</dependency>
@Grapes(
@Grab(group='org.hibernate.lucene-jbossmodules', module='lucene-jbossmodules-parent', version='5.5.5.hibernate06')
)
libraryDependencies += "org.hibernate.lucene-jbossmodules" % "lucene-jbossmodules-parent" % "5.5.5.hibernate06"
[org.hibernate.lucene-jbossmodules/lucene-jbossmodules-parent "5.5.5.hibernate06"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

  • jbossmodules
  • integrationtests

Apache Lucene JBoss Module as WildFly feature pack

This creates a set of JBoss Modules containing Apache Lucene and packages the lucene libraries into a WildFly feature pack for easy provisioning into your custom WildFly server or WildFly Swarm.

Historically the Hibernate Search project has been releasing such modules, for convenience of Apache Lucene users running applications on WildFly or JBoss EAP.

We now moved these artifacts to a "Lucene only" bundle so that other projects using Lucene don't have to download the Hibernate Search specific modules, and to attempt to have a single consistent distribution of such modules.

This should also make it easier to release a new bundle of these modules as soon as a new Lucene version is released, without necessarily waiting for Hibernate Search to have adopted the new Lucene version.

Version conventions

We will use an X.Y.Z.qualifier pattern as recommended by JBoss Project Versioning, wherein the X.Y.Z section will match the version of the Apache Lucene version included in the modules, possibly using a 0 for the last figure when this is missing in the Lucene version scheme.

We will add an additional qualifier, lexicographically increasing with further releases, to distinguish different releases of this package when still containing the same version of Apache Lucene library. This might be useful to address problems in the package structure, or any other reason to have to release a new version of these modules containing the same Lucene version as a previously released copy of these modules.

An example version could be 5.5.0.hibernate02 to contain Apache Lucene version 5.5.

Usage: server provisioning via Maven

Maven users can use the wildfly-server-provisioning-maven-plugin to create a custom WildFly server including these modules:

<plugins>
	<plugin>
	<groupId>org.wildfly.build</groupId>
	<artifactId>wildfly-server-provisioning-maven-plugin</artifactId>
	<version>1.2.0.Final</version>
	<executions>
		<execution>
		<id>server-provisioning</id>
		<goals>
			<goal>build</goal>
		</goals>
		<phase>compile</phase>
		<configuration>
			<config-file>server-provisioning.xml</config-file>
			<server-name>minimal-wildfly-with-lucene</server-name>
		</configuration>
		</execution>
	</executions>
</plugin>

You will also need a server-provisioning.xml in the root of your project:

<server-provisioning xmlns="urn:wildfly:server-provisioning:1.1">
	<feature-packs>

		<feature-pack
			groupId="org.hibernate.lucene-jbossmodules"
			artifactId="lucene-jbossmodules"
			version="${lucene-modules.version}"/>

		<feature-pack
			groupId="org.wildfly"
			artifactId="wildfly-servlet-feature-pack"
			version="${your-preferred-wildfly.version}" />

	</feature-packs>
</server-provisioning>

This will make Lucene available as an opt-in dependency to any application deployed on WildFly. To enable the dependency there are various options, documented in Class Loading in WildFly.

N.B.:

  • The current version of these modules has been tested with WildFly 11.0.0.Final.
  • Depending on the WildFly feature pack you chose, some transitive dependencies may not be available in Maven Central. In that case, you should set up the JBoss Nexus repository.

Non-Maven users

Plugins for other build tools have not been implemented yet, but this should be quite straight forward to do: the above Maven plugin is just a thin wrapper invoking other libraries; these other libraries are build agnostic and are responsible for performing most of the work.

See also WildFly provisioning build tools.

The feature packs are also available for downloads as zip files on JBoss Nexus.

How to build

Use the provided settings-example.xml file, so that JBoss-specific dependencies can be found:

mvn -s settings-example.xml clean install

How to release

mvn -s settings-example.xml release:prepare
mvn -s settings-example.xml release:perform

This will produce two local commits and a local tag, then upload the artifacts to a staging repository on JBoss Nexus.

If it all works fine, don't forget to:

  • release the staging repository on Nexus
  • push the commits
  • push the tag
org.hibernate.lucene-jbossmodules

Hibernate

Versions

Version
5.5.5.hibernate06
5.5.5.hibernate05
5.5.5.hibernate04
5.5.5.hibernate03
5.5.5.hibernate02
5.5.5.hibernate01