*This is the final 1.0.0 release of SteemJ-Image-Upload that heavily improves the code quality.*

<center>
![SteemJImageUploadLogo](https://imgur.com/npjYMLy.png)
</center>

# SteemJ-Image-Upload 1.0.0 has been released ~ Upload Images to steemitimages.com out of your Java Application
<br>Hello Steemians!

about three weeks ago I've decided to make Steem-Image-Upload public and released a first pre-release to collect feedback from you guys (checkout [the announcement post](https://steemit.com/utopian-io/@dez1337/steemj-image-upload-has-been-released-upload-images-to-steemitimages-com-out-of-your-java-application)). So far, I've only received positive feedback and in addition testers like @paatrick mentioned that everything is working fine. Thanks for that! =)

While everything seems to work perfectly, I still had some code quality related tasks on my side. In example:
* The whole project had 0 tests and no documentation at all 
* It supported no possibility to debug it as 0 logs were available
* It was pretty heavy as it was based on big libraries while only using a small part of them

This release solves all those issues so that I feel more than confident to give this version the number 1.0.0 which makes SteemJ-Image-Upload my first Steem related tool that I would call "finished". 

# Changelog for version 1.0.0

* [Issue #01](https://github.com/marvin-we/steemj-image-upload/issues/1) - Use crypto-core instead of bitcoinj to reduce the size of the project
* [Issue #02](https://github.com/marvin-we/steemj-image-upload/issues/2) - Add timeout configuration to the Config object
* [Issue #04](https://github.com/marvin-we/steemj-image-upload/issues/4) - Add a logging framework and implement proper logging
* [Issue #05](https://github.com/marvin-we/steemj-image-upload/issues/5) - Add, implement and use proper Exceptions
* [Issue #06](https://github.com/marvin-we/steemj-image-upload/issues/6) - Update dependencies
* [Issue #07](https://github.com/marvin-we/steemj-image-upload/issues/7) - Add a proper copyright header
* [Issue #08](https://github.com/marvin-we/steemj-image-upload/issues/8) - Add a license
* [Issue (PR) #09](https://github.com/marvin-we/steemj-image-upload/pull/9) - Create LICENSE
* [Issue #10](https://github.com/marvin-we/steemj-image-upload/issues/10) - Do not depend on SteemJ
* [Issue #11](https://github.com/marvin-we/steemj-image-upload/issues/11) - Secure the functionality with tests

# Changes in Detail
The only change that will effect you, as a user, is the addition of a logging framework. Based on the experience made with SteemJ I only added the **slf4j-api** to the project. This gives you all the flexibility to choose the implementation on your own, so if you have an Android project, you can choose a logging framework that will actually work there, while you can still add common logging implementations like **log4j2** if you develop a common desktop or server application.

If no slf4j-implementation is added at all, you will face the following *WARNING* messages at start up if no implementation has been provided:

> SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder".
> SLF4J: Defaulting to no-operation (NOP) logger implementation
> SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further details.

## Adding a slf4j-implementation to your project
One good example of an alternative slf4j implementation is log4j-slf4j-impl, which implements the slf4j-api and adds the powerfull configuration options of log4j2.

As a first step, the **log4j-slf4j-impl** jar needs to be added to your project. The most easiest way to achieve this is the usage of a Build-Management tool like Maven, because you only need to add the required dependencies the pom.xml.

```XML
<dependency>
	<groupId>org.apache.logging.log4j</groupId>
	<artifactId>log4j-slf4j-impl</artifactId>
	<version>${log4j.version}</version>
</dependency>
<dependency>
	<groupId>org.apache.logging.log4j</groupId>
	<artifactId>log4j-core</artifactId>
	<version>${log4j.version}</version>
</dependency>
```

To finalize the logging configuration of your project, create a **log4j2.xml** and add it to the *src/main/resources* folder. An example log4j2.xml configuration is shown below.

```XML
<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
	<Appenders>
		<Console name="Console" target="SYSTEM_OUT">
			<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n" />
		</Console>
	</Appenders>
	<Loggers>
		<Logger name="eu.bittrade.libs.steemj.image.upload" level="WARN">
			<AppenderRef ref="Console" />
		</Logger>
		<Logger name="my.project" level="DEBUG">
			<AppenderRef ref="Console" />
		</Logger>
		<Root level="ERROR" />
	</Loggers>
</Configuration>
```

The configuration above would append all log messages of:
* SteemJ-Image-Upload, that have a severity of WARN or higher
* your project (package my.project), that have a severity of DEBUG or higher 
to the console, while ignoring all other log messages, because no logger is defined for Root.

If you want to use log4j2 in your project too, you should have a look at the [official documentation](https://logging.apache.org/log4j/2.0/manual/configuration.html) to find detailed configuration examples.

# General Project information

## What is SteemJ-Image-Upload?
SteemJ-Image-Upload is a sub-project of [SteemJ](https://github.com/marvin-we/steem-java-api-wrapper) - The Steem API for Java. 

[SteemJ Image Upload](https://github.com/marvin-we/steemj-image-upload) allows to upload images to ([https://steemitimages.com](https://steemitimages.com)) out of your Java application.

The project has been initialized by <a href="https://steemit.com/@dez1337">dez1337 on steemit.com</a>.

## Technologies
* Java 7 
* Maven 3+ for building the project
* [Crypto-Core](https://steemit.com/utopian-io/@dez1337/crypto-core-a-swiss-army-knife-for-blockchain-related-java-projects) to sign the image with your private posting key
* Google HTTP Client 
* SLF4J 
* WireMock to simulate a steemitimages.com response during test execution

## Quick start guide
Using SteemJ-Image-Upload is really easy: Add it to your project and upload your first image as shown below.

### Add SteemJ-Image-Upload to your project
SteemJ Image Upload binaries are pushed into the maven central repository and can be integrated with a bunch of build management tools like Maven.

**File:** *pom.xml*
```XML
<dependency>
    <groupId>eu.bittrade.libs</groupId>
    <artifactId>steemj-image-upload</artifactId>
    <version>1.0.0</version>
</dependency>
```

### Write a Java Class to upload an Image
SteemJ Image Upload is really easy to use. The following code shows a full sample:

```Java
import java.io.File;
import java.io.IOException;
import java.net.URL;

import eu.bittrade.libs.steemj.base.models.AccountName;
import eu.bittrade.libs.steemj.image.upload.SteemJImageUpload;

public class ExampleApplication {
    public static void main(String args[]) {
        AccountName myAccount = new AccountName("dez1337");
        // Please be informed that this is not the correct private key of dez1337.
        String myPrivatePostingKeyAsWif = "5KMamixsFoUkdlz7sNG4RsyaKQyJMBBqrdT6y54qr4cdVhU9rz7";
        File imageToUpload = new File("C:/Users/dez1337/Desktop/SteemJImageBanner.png");

        try {
            URL myImageUrl = SteemJImageUpload.uploadImage(myAccount, myPrivatePostingKeyAsWif, imageToUpload);
            System.out.println("The image has been uploaded and is reachable using the URL: " + myImageUrl);
        } catch (IOException e) {
            System.out.println("There was a problem uploading the image.");
            e.printStackTrace();
        }
    }
}
```

An output of the code above will look like this:
> The image has been uploaded and is reachable using the URL: https:/<span>/steemitimages.com/DQmfWn1z6HwwxfaWhrpY28MYh43wEEyNsV25GnGSGZUDo2U/SteemJImageSteemFriendlyWithUpdatetBanner.png

As you can see in the sample above, your account name and your private posting are required to upload an image - If you do not provide those details, your upload request will not be accepted. For sure, SteemJ-Image-Upload will not send or store your private posting key!

If you have security doubts about it you can:
* Check the [official imagehoster README file](https://github.com/steemit/imagehoster/blob/master/README.md)
* Review the SteemJ-Image-Upload source code at GitHub.

## Bugs reports, feedback and discussions
For bugs or feature requests please create a [GitHub Issue](https://github.com/marvin-we/steemj-image-upload/issues). 

For general discussions or questions you can also:
* Post your questions in the [Discord Java Channel](https://discord.gg/fsJjr3Q)
* Reply to one of the *Crypto Core* update posts on [Steemit.com](https://steemit.com/@dez1337)
* Contact me on [steemit.chat](https://steemit.chat/channel/dev)

## Contribute
Bug reports and feature requests already help a lot to improve the project. What helps even more is an active contribution, so if you see something to improve, I would love to see a [pull request](https://help.github.com/articles/creating-a-pull-request/) from you.

> git clone https://github.com/marvin-we/steemj-image-upload

# 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).

<hr>
<center>Thanks for reading and best regards,
@dez1337
</center>

<br /><hr/><em>Posted on <a href="https://utopian.io/utopian-io/@dez1337/steemj-image-upload-1-0-0-has-been-released-upload-images-to-steemitimages-com-out-of-your-java-application">Utopian.io -  Rewarding Open Source Contributors</a></em><hr/>