SteemJ Dev Diary #4 (04.01.2018) - The DatabaseApi

View this thread on: d.buzz | hive.blog | peakd.com | ecency.com
·@dez1337·
0.000 HBD
SteemJ Dev Diary #4 (04.01.2018) - The DatabaseApi
*Day #4 of the SteemJ Dev Diary was mainly focused on the MarketHistoryAPI rework and a knowledge transfer with @paatrick.*

<center>
![SteemJV2Logo](https://imgur.com/BkxgLFB.png)
</center>

<center>
Latest SteemJ 0.4.x releases: [0.4.3](https://steemit.com/utopian-io/@dez1337/steemj-v0-4-3-is-available-now-use-the-steem-api-in-your-java-project) [v0.4.2](https://steemit.com/utopian-io/@dez1337/steemj-v0-4-2-is-available-now-use-the-steem-api-in-your-java-project) [v0.4.2pr1](https://steemit.com/steemdev/@dez1337/steemj-v0-4-1-has-been-released-use-the-steem-api-in-your-java-project) [v0.4.1](https://steemit.com/steemdev/@dez1337/steemj-v0-4-1-has-been-released-use-the-steem-api-in-your-java-project) [v0.4.0](https://steemit.com/steemdev/@dez1337/steemj-v0-4-0-has-been-released-integrate-steem-into-your-java-project) 
</center>

# SteemJ Dev Diary #4 (04.01.2018) - The DatabaseApi
<br>Hello Steemians and welcome back to day #4 of the SteemJ HF 0.20 Dev Diary! 

This series has been introduced to collect feedback from you and to motivate myself to finalize the next SteemJ version as soon as possible. If this is the first part of this series you read, you may want to checkout [Day #1](https://steemit.com/utopian-io/@dez1337/steemj-dev-diary-1-01-01-2018-cryptocore-and-code-cleanups) which explains the motivation behind this diary in detail and also provides a first overview of the API changes that come with HF 0.20.

# Changes during day #4
The last 2 days have been quite frustrating, because I can't test the changes properly as a Steem Node running HF 0.19.2 is serving the API Endpoint behind [https://api.steemitdev.com](https://api.steemitdev.com). As there are only three days left for this diary and the target was to finish as much as possible, I tried to make good use of the time.

After [yesterdays rework](https://steemit.com/utopian-io/@dez1337/steemj-dev-diary-3-03-01-2018-the-markethistoryapi-rework) of the MarketHistoryAPI I had a look at the DatabaseApi today (Tracked in [Issue #75](https://github.com/marvin-we/steem-java-api-wrapper/issues/75).

In [commit 362af1](https://github.com/marvin-we/steem-java-api-wrapper/commit/362af1701ec2ee9c86c9b22853681732a0069924) all changes can be seen. I basically moved methods from the 'SteemJ' class into a separate 'DatabaseApi' class, added new methods like 'listWitnesses' and 'findWitnesses' and, in addition, created the '_args' and '_return' for the different methods.

The package structure itself becomes quite clean now:

<center>
![PackageStructure](https://imgur.com/If9cW82.png)
</center>

But there is still a lot to do. 

The most important thing for me right now is the possibility to test the parts that have already been changed. Together with @paatrick we planned to spend some hours to setup a Steem Node using the official [Steem Docker Image](https://hub.docker.com/r/steemit/steem/tags/) as also the current development state is available as a docker image.

This node should help us a lot :)

A list of all commits made after the last release can be found here: [https://github.com/marvin-we/steem-java-api-wrapper/compare/v0.4.3...master](https://github.com/marvin-we/steem-java-api-wrapper/compare/v0.4.3...master)

*(A prove that the commits have been made by me can [be found here](https://steemit.com/utopian-io/@dez1337/steemj-image-upload-1-0-0-has-been-released-upload-images-to-steemitimages-com-out-of-your-java-application#@dez1337/re-codingdefined-re-dez1337-steemj-image-upload-1-0-0-has-been-released-upload-images-to-steemitimages-com-out-of-your-java-application-20171217t115152531z))*

# General information
## What is SteemJ?
SteemJ is a project that allows you to communicate with a Steem node using Java. So far, the project supports most of the API calls and is also able to broadcast most of the common operation types. Further information can be found on [GitHub](https://github.com/marvin-we/steem-java-api-wrapper).

> https://github.com/marvin-we/steem-java-api-wrapper

## Quick Start Guide

### Add SteemJ to your project
SteemJ binaries are pushed into the maven central repository and can be integrated with a bunch of build management tools like Maven. The [Wiki](https://github.com/marvin-we/steem-java-api-wrapper/wiki/How-to-add-SteemJ-to-your-project) provides a lot of examples for the most common build tools. If you do not use a build management tool you can download the binaries as described [here](https://github.com/marvin-we/steem-java-api-wrapper/wiki/How-to-add-SteemJ-to-your-project#download).

To add this release to your project paste the following snippet into your 'pom.xml'

```XML
<dependency>
    <groupId>eu.bittrade.libs</groupId>
    <artifactId>steemj-core</artifactId>
    <version>0.4.3</version>
</dependency>
```

### Start posting

```Java
SteemJConfig myConfig = SteemJConfig.getInstance();

myConfig.setDefaultAccount(new AccountName("YOUR-ACCOUNT"));

List<ImmutablePair<PrivateKeyType, String>> privateKeys = new ArrayList<>();
privateKeys.add(new ImmutablePair<>(PrivateKeyType.POSTING, "YOUR-PRIVATE-POSTING-KEY"));

myConfig.getPrivateKeyStorage().addAccount(myConfig.getDefaultAccount(), privateKeys);

steemJ.createComment(new AccountName("steemj"), new Permlink("testofsteemj040"), "Example comment without no link but with a @user .", new String[] { "test" });

```

### Further information
The [sample module](https://github.com/marvin-we/steem-java-api-wrapper/tree/master/sample) of the SteemJ project provides showcases for the most common acitivies and operations users want to perform. 

Beside that you can find a lot of snippets and examples in the different [Wiki sections](https://github.com/marvin-we/steem-java-api-wrapper/wiki).  

## Contribute
The project became quite big and there is still a lot to do. If you want to support the project simply clone the git repository and submit a pull request. I would really appreciate it =).

> git clone https://github.com/marvin-we/steem-java-api-wrapper.git

## Get in touch!
Most of my projects are pretty time consuming and I always try to provide some useful stuff to the community. What keeps me going for that is your feedback and your support. For that reason I would love to get some Feedback from you <3. Just contact me here on [Steemit](https://steemit.com/@dez1337) or ping me on [GitHub](https://github.com/marvin-we/steem-java-api-wrapper).

<br /><hr/><em>Posted on <a href="https://utopian.io/utopian-io/@dez1337/steemj-dev-diary-4-04-01-2018-the-databaseapi">Utopian.io -  Rewarding Open Source Contributors</a></em><hr/>
👍 , , , , , , , , , , , , , , , , , , , , , , , , ,