<commit_before># marklogic-samplestack

README for Version 1.0.0-EA3 (In Progress)

Samplestack is a demo "Question and Answer" web application that shows you how to integrate MarkLogic into a three-tier application architecture (browser, application server, and database).

This release features a middle tier for the Java Enterprise Developer, implemented using Java, Spring, and Gradle.

The project includes the following major components:
* Web/browser front end based on Angular.js
* Middle appserver tier implemented in Java/Spring
* Database tier hosted on MarkLogic
* Gradle framework to drive build and configuration of the appserver and database tiers
* Unit tests

This README covers the following topics:
* [Prerequisites](#prerequisites)
* [Getting Started](#getting-started)
* [Additional Information](#additional-information)
* [License](#license)

## Prerequisites
To configure and use this application, you need the following software:
* Java JDK 1.7 or 1.8
* Latest MarkLogic 8.0 Nightly Build (see instructions [below](#getting-started))
* Node.js, version 0.10 or later. See [nodejs.org](http://nodejs.org).
* A global installation of the Node.js components [bower](http://bower.io) and [gulp](https://github.com/gulpjs/gulp). For details, see [Global Utilities](browser/README.md#global-utilities) in the [browser README](browser/README.md).

The setup instructions assume you have the `git`, `javac`, `node`, `bower`, and `gulp` commands on your path.

The setup procedure may install additional software, such as Gradle and Angular.

## Getting Started

*note for development branch work:*

This README is for a development branch that does not work with any released version of MarkLogic

Use Latest MarkLogic nightly for your platform:

http://root.marklogic.com/nightly/default.xqy?branch=HEAD

Java Client API needs snapshot available on commit [481c2b045ad5bc6f0549ad4e60e44b7cec5232a6](https://github.com/marklogic/java-client-api/commit/481c2b045ad5bc6f0549ad4e60e44b7cec5232a6) from 11/5/2014.  This should be installed
automatically but may require gradle or maven cache cleaning.

_**If** you are using OSX and have access to the nightly builds site,_ an MLVM script is available to fully configure the Java Middle Tier, including the download/installation of the latest nightly, dowload/loading of seed data and initialization and starup of of the middle-tier:

https://github.com/marklogic/marklogic-samplestack/blob/develop/appserver/java-spring/cleanstart.sh

If you are not using OSX, the script may be helpful in understanding the steps, should you wish to examine it and/or adapt it for your platform.

*end note*


Follow this procedure to set up Samplestack in your environment.

1. Install MarkLogic 8 Early Access. See http://ea.marklogic.com/download.

2. Start MarkLogic. For details, see the [MarkLogic Installation Guide](http://docs.marklogic.com/guide/installation/procedures#id_92457).

3. Clone this repository. For example, run the following command:  

    ```
    git clone https://github.com/marklogic/marklogic-samplestack
    ```
4. [Set up the middle and database tiers](#setting-up-the-middle-and-database-tiers).

5. [Set up the browser tier](#setting-up-the-browser-tier).


### Setting Up the Middle and Database Tiers
The setup assume you have MarkLogic Server running on your localhost and that your Admin user credentials are admin:admin. To change this, modify `appserver/java-spring/gradle.properties`.

To install required software, configure, and build the Java middle tier and database tier of Samplestack, run the following commands from the root of your cloned repository:
<commit_msg>chore(readme): update readme for EA3 dependencies<commit_after># marklogic-samplestack

README for Version 1.0.0-EA3 (In Progress)

Samplestack is a demo "Question and Answer" web application that shows you how to integrate MarkLogic into a three-tier application architecture (browser, application server, and database).

This release features a middle tier for the Java Enterprise Developer, implemented using Java, Spring, and Gradle.

The project includes the following major components:
* Web/browser front end based on Angular.js
* Middle appserver tier implemented in Java/Spring
* Database tier hosted on MarkLogic
* Gradle framework to drive build and configuration of the appserver and database tiers
* Unit tests

This README covers the following topics:
* [Prerequisites](#prerequisites)
* [Getting Started](#getting-started)
* [Additional Information](#additional-information)
* [License](#license)

## Prerequisites
To configure and use this application, you need the following software:
* Java JDK 1.7 or 1.8
* MarLogic 8.0 Early Acceess Release 3 (EA3) (see instructions [below](#getting-started))
* Node.js, version 0.10 or later. See [nodejs.org](http://nodejs.org).
* A global installation of the Node.js components [bower](http://bower.io) and [gulp](https://github.com/gulpjs/gulp). For details, see [Global Utilities](browser/README.md#global-utilities) in the [browser README](browser/README.md).

The setup instructions assume you have the `git`, `javac`, `node`, `bower`, and `gulp` commands on your path.

The setup procedure may install additional software, such as Gradle and Angular.

## Getting Started

Follow this procedure to set up Samplestack in your environment.

1. Install MarkLogic 8 Early Access 3 (EA3). See http://ea.marklogic.com/download.

2. Start MarkLogic. For details, see the [MarkLogic Installation Guide](http://docs.marklogic.com/guide/installation/procedures#id_92457).

3. Clone this repository. For example, run the following command:  

    ```
    git clone https://github.com/marklogic/marklogic-samplestack
    ```
4. [Set up the middle and database tiers](#setting-up-the-middle-and-database-tiers).

5. [Set up the browser tier](#setting-up-the-browser-tier).


### Setting Up the Middle and Database Tiers
The setup assume you have MarkLogic Server running on your localhost and that your Admin user credentials are admin:admin. To change this, modify `appserver/java-spring/gradle.properties`.

To install required software, configure, and build the Java middle tier and database tier of Samplestack, run the following commands from the root of your cloned repository:

{'fraction_non_alphanumeric': 0.0845652519472262, 'fraction_numerical': 0.017167381974248927, 'mean_word_length': 4.9414542020774315, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 5, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4567165', 'n_tokens_mistral': 1849, 'n_tokens_neox': 1723, 'n_words': 731}