Click here to find out what's new

Bot Framework SDK for Java (Preview)

This repository contains code for the Java version of the Microsoft Bot Framework SDK. The Bot Framework SDK v4 enable developers to model conversation and build sophisticated bot applications.

This repo is part of the Microsoft Bot Framework - a comprehensive framework for building enterprise-grade conversational AI experiences.

To get started see the Azure Bot Service Documentation for the v4 SDK.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Linting rules

This project uses linting rules to enforce code standardization. These rules are specified in the file bot-checkstyle.xml with CheckStyle and are hooked to Maven's build cycle.

INFO: Since the CheckStyle and PMD plugins are hooked into the build cycle, this makes the build fail in cases where there are linting warnings in the project files. Errors will be in the file ./target/checkstyle-result.xml and ./target/pmd.xml.

CheckStyle is available in different flavours:

• Visual Studio Code plugin
• IntelliJ IDEA plugin
• Eclipse plugin
• CLI Tool

INFO: Be sure to configure your IDE to use the file bot-checkstyle.xml instead of the default rules.

Build and IDE

Any IDE that can import and work with Maven projects should work. As a matter of practice we use the command line to perform Maven builds. If your IDE can be configured to defer build and run to Maven it should also work.

• Java

  • We use the Azul JDK 8 to build and test with. While not a requirement to develop the SDK with, it is recommended as this is what Azure is using for Java 1.8. If you do install this JDK, make sure your IDE is targeting that JVM, and your path (from command line) and JAVA_HOME point to that.

• Visual Studio Code

  • Extensions
    • Java Extension Pack by Microsoft
    • EditorConfig for VS Code by EditorConfig (Recommended)

• IntelliJ

  • Extensions
    • Checkstyle by IDEA
  • Recommended setup
    • When importing the SDK for the first time, make sure "Auto import" is checked.

Reporting Security Issues

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) at secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

Copyright (c) Microsoft Corporation. All rights reserved.