Support

How to get help?

Use bean-cp project forum.

How to report a bug?

Bugs, new features and other issues are tracked using beancp.atlassian.net website. If you want to have insight into current project status or report a bug you have to use this site. You can browse project's issues without account, but to report a bug you need to sign up.

When you want to report a bug please always include in bug report:

  • Summary – quick overview of the problem
  • Priority – choose minor (usually for documentation) or major (significant implementation bugs)
  • For implementation bugs attach exactly one .java file (may include inner classes) with unit test (or tests). This test must prove that bug exists. JUnit is the only allowed testing framework. If it is possible then unit test should have no external dependencies. If not then attach proper pom.xml (if you are not familiar with pom.xml then read "Introduction to the POM"). All declared dependencies must be available in public Maven repositories. Finally, please try to follow style of below test:
    package com.github.erchu.beancp;
    
    import org.junit.Test;
    import static org.junit.Assert.*;
    
    public class BindConstantTest {
    
        public static class Source {
    
            private String x;
    
            private String y;
    
            public String getX() {
                return x;
            }
    
            public void setX(String x) {
                this.x = x;
            }
    
            public String getY() {
                return y;
            }
    
            public void setY(String y) {
                this.y = y;
            }
        }
    
        public static class Destination {
    
            private String a;
    
            private String b;
    
            public String getA() {
                return a;
            }
    
            public void setA(String a) {
                this.a = a;
            }
    
            public String getB() {
                return b;
            }
    
            public void setB(String b) {
                this.b = b;
            }
        }
    
        @Test
        public void mapper_should_bind_constants() {
            // GIVEN
            Source sampleSource = new Source();
            sampleSource.setX("xval");
            sampleSource.setY("yval");
    
            Mapper mapper = new MapperBuilder()
                    .addMap(Source.class, Destination.class,
                            (config, source, destination) -> config
                            .bindConstant("const", destination::setA))
                    .buildMapper();
    
            // WHEN
            Destination result = mapper.map(sampleSource, Destination.class);
    
            // THEN
            assertEquals(
    			"Destination property 'a' is not mapped correctly.",
    			"const",
    			result.getA());
    			
            assertNull(
    			"Destination property 'b' is not mapped correctly.",
    			result.getB());
        }
    }
    
  • Description
  • Affected version – version of bean-cp
  • Environment – operating system name and version, JRE version information (output from java -v command) and optionally Java application server name and version. For example:
    Windows 7 Professional Service Pack 1
    
    java version "1.8.0_20"
    Java(TM) SE Runtime Environment (build 1.8.0_20-b26)
    Java HotSpot(TM) 64-Bit Server VM (build 25.20-b23, mixed mode)
    
    Java application server: Apache TomEE WebProfile 1.7.0
    

Bug workflow diagram:

Transitions to be made by reporter:

  • → Open (bug registration)
  • Valid fix: Resolved → Ready for release if fix is ready and reporter agree that is valid
  • Open: Resolved → Open if fix is ready, but reporter disagree that is valid

How to request for a new feature?

Please post any feedback, ideas, etc. on "What do you think about bean-cp?" (thread on project forum).