Skip to content

Commit

Permalink
Updated docs with Maven artifacts.
Browse files Browse the repository at this point in the history
  • Loading branch information
woemler committed Mar 19, 2016
1 parent 2e2cce2 commit 955b343
Show file tree
Hide file tree
Showing 5 changed files with 79 additions and 3 deletions.
28 changes: 27 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,33 @@ Database-specific implementations of the core repository interfaces and data imp
The web module contains all components of the REST web services, including security and API documentation tools.

## Quick Start
Please see each individual module's README for instructions on getting started.
Please see each individual module's README for instructions on getting started. Artifacts for Centromere release builds are available from the Maven Central Repository:

```xml
<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-core</artifactId>
<version>0.3.0</version>
</dependency>

<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-mongodb</artifactId>
<version>0.3.0</version>
</dependency>

<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-sql</artifactId>
<version>0.3.0</version>
</dependency>

<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-web</artifactId>
<version>0.3.0</version>
</dependency>
```

## Contact

Expand Down
12 changes: 12 additions & 0 deletions centromere-core/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,18 @@ Components for creating database repositories for Centromere data warehouses. T

## Quick Start

### Maven

You can get the latest release build of the Centromere Core module from Maven Central Repository:

```xml
<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-core</artifactId>
<version>0.3.0</version>
</dependency>
```

### Creating a Data Model

The first step in implementing a data warehouse with Centromere is to design a data model and create representational Java classes for each entity. Once implemented, a single model class will be used for each web service endpoint, so model classes should be considered to be atomic, normalized entities. All data model entity classes should implement the `Model` interface:
Expand Down
16 changes: 14 additions & 2 deletions centromere-mongodb/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,18 @@ Repository class implementations for MongoDB.

## Quick Start

### Maven

You can get the latest release build of the Centromere MongoDb module from Maven Central Repository:

```xml
<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-mongodb</artifactId>
<version>0.3.0</version>
</dependency>
```

### Creating Repositories

The `GenericMongoRepository` is the MongoDB implementation of `RepositoryOperations`, utilizing Spring Data MongoDB's `MongoTemplate` for query execution and object mapping. Before creating repository classes, you should configure your database connection:
Expand All @@ -13,7 +25,7 @@ The `GenericMongoRepository` is the MongoDB implementation of `RepositoryOperati
@Configuration
@PropertySource({ "classpath:mongodb-data-source.properties" })
public class MongoConfig extends AbstractMongoConfiguration {

@Autowired private Environment env;

@Override
Expand All @@ -33,7 +45,7 @@ public class MongoConfig extends AbstractMongoConfiguration {
));
return new MongoClient(serverAddress, credentials);
}

}
```

Expand Down
14 changes: 14 additions & 0 deletions centromere-sql/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,20 @@ Repository implementations for SQL databases.

## Quick Start

### Maven

You can get the latest release build of the Centromere SQL module from Maven Central Repository:

```xml
<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-sql</artifactId>
<version>0.3.0</version>
</dependency>
```

### Creating Repositories

The `GenericJdbcRepository` is the JDBC SQL database implementation of `RepositoryOperations`. This repository implementation is based on `com.nurkiewicz.jdbcrepository.JdbcRepository`, but uses a more complex version of the `TableDescription` class, and a custom SQL generation class, `SqlBuilder`. Much like with `JdbcRepository`, you define a `GenericJdbcRepository` using a `ComplexTableDescription`, `RowMapper`, and optional `RowUnmapper`. For example:

```java
Expand Down
12 changes: 12 additions & 0 deletions centromere-web/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,18 @@ Components for creating REST web services that sit on top of a Centromere data w

## Quick Start

### Maven

You can get the latest release build of the Centromere Web module from Maven Central Repository:

```xml
<dependency>
<groupId>org.oncoblocks.centromere</groupId>
<artifactId>centromere-web</artifactId>
<version>0.3.0</version>
</dependency>
```

### Configuration

The easiest way to configure Centromere is to use the available auto-configuration annotations in a Spring Boot application class or supporting configuration class: `@AutoConfigureWebServices`, `@AutoConfigureWebSecurity`, and `@AutoConfigureApiDocumentation`. This will handle all of the required web context configuration and bean registration for the web services, API documentation, and security features:
Expand Down

0 comments on commit 955b343

Please sign in to comment.