Need help with design-patterns-java?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

457 Stars 136 Forks Other 63 Commits 4 Opened issues


Design Pattern Examples in Java

Services available


Need anything else?

Contributors list

Design Patterns in Java

This repository is part of the Refactoring.Guru project.

It contains Java examples for all classic GoF design patterns.


The examples were written in Java 8, but also tested in Java 9.

For the best experience, we recommend working with examples in IntelliJ IDEA. The Community Edition of IDE is available for free (

After downloading or cloning this repository to your computer, import its root directory into a New project:

  • Either through start dialog: Select "Import Project" option and skip through the rest of the steps.

  • Or via the main menu: File > New > Project from Existing Sources...

After importing the project, you will be able to run examples by right-clicking "Demo" files inside every example and selecting the "Run" command from the context menu.


  • [ ] Add detailed comments all classes.
  • [ ] Add structure-only examples.

Contributor's Guide

We appreciate any help, whether it's a simple fix of a typo or a whole new example. Just make a fork, do your change and submit a pull request.

Here's a style guide which might help you to keep your changes consistent with our code:

  1. All code should meet the Google Java Style Guide

  2. Try to hard wrap the code at 80th's character. It helps to list the code on the website without scrollbars.

  3. Examples should match following package convention: refactoringguru.{pattern}.{examplename}. Example:

    package refactoring_guru.factory_method.ui_example.buttons;

    class Button { ...

  4. Places classes into separate files.

  5. Group classes into sub-packages. It helps people to understand dependencies of a class by glancing over its imports. Example:

    package refactoring_guru.factory_method.example.buttons;

    class Button { ...

    package refactoring_guru.factory_method.example.factories;
    import Button;
    class Factory {
  6. Comments may or may not have language tags in them, such as this:

     * EN: All products families have the same varieties (MacOS/Windows).
     * This is a MacOS variant of a button.
     * RU: Все семейства продуктов имеют одни и те же вариации (MacOS/Windows).
     * Это вариант кнопки под MacOS.

    Don't be scared and ignore the non-English part of such comments. If you want to change something in a comment like this, then do it. Even if you do it wrong, we'll tell you how to fix it during the Pull Request.


This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International License.

Creative Commons License


Authors: Bohdan Herashchenko (@b1ger) and Alexander Shvets (@neochief)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.