https://github.com/ipb-halle/molecularfaces

Java Server Faces UI components for chemistry and biochemistry
https://github.com/ipb-halle/molecularfaces

biochemistry biology chemical-structure chemistry genetics javaserverfaces jsf

Last synced: 3 months ago
JSON representation

Java Server Faces UI components for chemistry and biochemistry

• Host: GitHub
• URL: https://github.com/ipb-halle/molecularfaces
• Owner: ipb-halle
• License: apache-2.0
• Created: 2021-01-25T09:40:01.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-05-16T09:36:26.000Z (over 1 year ago)
• Last Synced: 2025-07-04T22:09:24.222Z (4 months ago)
• Topics: biochemistry, biology, chemical-structure, chemistry, genetics, javaserverfaces, jsf
• Language: Java
• Homepage:
• Size: 241 KB
• Stars: 2
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# MolecularFaces

[![Javadoc](https://javadoc.io/badge2/de.ipb-halle/molecularfaces/javadoc.svg)](https://javadoc.io/doc/de.ipb-halle/molecularfaces)

[![Maven Central](https://img.shields.io/maven-central/v/de.ipb-halle/molecularfaces)](https://mvnrepository.com/artifact/de.ipb-halle/molecularfaces/latest)

[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/de.ipb-halle/molecularfaces?server=https%3A%2F%2Fs01.oss.sonatype.org)](https://s01.oss.sonatype.org/content/repositories/snapshots/de/ipb-halle/molecularfaces/)

[![Maven Build](https://github.com/ipb-halle/MolecularFaces/actions/workflows/maven-deploy-to-ossrh.yml/badge.svg)](https://github.com/ipb-halle/MolecularFaces/actions/workflows/maven-deploy-to-ossrh.yml)

[![Maven dependency check](https://github.com/ipb-halle/MolecularFaces/actions/workflows/maven-dependency-check.yml/badge.svg)](https://github.com/ipb-halle/MolecularFaces/actions/workflows/maven-dependency-check.yml)

MolecularFaces is a collection of reusable UI components for Java Server Faces (JSF) featuring input and output plugins, validators and converters for chemistry and biochemistry data. It is a spin-off project of [CRIMSy (Cloud Resource & Information Management System)](https://github.com/ipb-halle/CRIMSy).

## [UI library for chemistry](docs/chemistry.md)

## [UI library for biology and biochemistry](docs/bio.md)

## Maven coordinates

The artifacts are available on Maven Central. To include MolecularFaces into your JSF project, add the following dependency to your project's pom.xml:

```xml

  de.ipb-halle

  molecularfaces

  0.4.0

```

Version 1.0.0 and above require JakartaEE. Use versions 0.x.y for JavaEE 7 projects. Snapshots can be included via

```xml

  snapshots-repo

  https://s01.oss.sonatype.org/content/repositories/snapshots/

  false

  true

...

  de.ipb-halle

  molecularfaces

  0.5.0-SNAPSHOT

```

## Usage

### XML Namespace

```xml

xmlns:mol="http://github.com/ipb-halle/MolecularFaces"

```

### Usage example

JSF view:

```xml

  

    MolecularFaces

  

  

    

      

      


      

    

  

```

JSF backing bean:

```Java

@Named

@RequestScoped

public class MyBean {

// structure in MDL Molfile V2000 format

private String structure = "";

// DNA/RNA sequence in JSON format

private String sequence = "";

// getters/setters

...

}

```

### Configuring resources via web.xml

MolecularFaces tries to include as much resources (JavaScript, CSS, images) of the third-party plugins in its jar as possible and loads them when required. Alternatively, you can configure the URL of the resources (relative to the application's context root) via a `context-param` in your project's web.xml.

Example:

```xml

  de.ipb-halle.molecularfaces.OPENCHEMLIBJS_URL

  openchemlib-full.js

```