How is @Implementation used?

Question

Recently I discovered ActiveObejcts and I really like it. Right now I'm using the last version from Atlassian plugin, only the net.java.ao part for ORM. Compiles and runs fine. Sure, I have to do some performance tests, if it fits my requirements.

There exists the @Implementation annotation. How is that used? The javadocs are very brief.

Update

Solution:

public class M5 {

public static void main(String[] args) throws SQLException {

        EntityManager m = EntityManagerBuilder
                .url("jdbc:hsqldb:./db/db")
                .username("root")
                .password("")
                .c3po()
                .build();

        m.migrate(Employee.class);

        Employee p = m.create(Employee.class);
        p.setFirstName("Peter");
        p.setLastName("Mmm");
        System.err.println(p.getLastName()); // prints "ln: Mmm"
        p.save();
    }
}

public class Emp {
    private Employee employee;

    public Emp(Employee employee) {
        this.employee = employee;
    }

    public String getLastName() {
        return "ln: " + employee.getLastName();
    }
}

@Implementation(Emp.class)
interface Employee extends Entity {
    String getFirstName();
    void setFirstName(String name);
    String getLastName();
    void setLastName(String name);
}
}

mac · Accepted Answer · 2014-03-23T12:00:55.933

5

Active Objects takes your interface and, via reflection through a complicated proxy translates your getters, setters and relations into SQL statements. If you want some of your own code in there to add or modify functionality of your AO interface, you can use @Implementation

Example:

AO interface:

@Implementation(PersonImpl.class)
public interface Person extends Entity {

  String getLastName();
  void setLastName(String name);

  String getFirstName();
  void setFirstName(String name);

  @Ignore
  String getName();
}

Implementation:

public class PersonImpl {

  private final Person person; // this will be the original entity proxy

  public PersonImpl(Person person) {
    this.person = person;
  }

  // "Implement" ignored functions
  public String getName() {
    return String.format("%s %s", this.person.getFirstName(), this.person.getLastName()); 
  }

  // "Enhance" AO getters/setters
  public void setFirstName(String name) {
    this.person.setFirstName("Foobar");
  }
}

Note that AO accesses these implementation methods via reflection. They must match the names in the interface. This might lead to problems during refactorings, as method names might change and your compiler won't tell you that your corresponding impl method name hasn't.

edited Mar 23 '14 at 12:00

answered Mar 23 '14 at 11:50

mac

161
7

Ok, I tried this with no success. How to use this now with the EntityManager ? – PeterMmm Mar 23 '14 at 12:22
@PeterMmm your're missing the constructor taking the original AO interface in your implementation class. In this case, AO probaby won't take the impl. If it did, your this.employee would be null anyway. – mac Mar 23 '14 at 12:26
Done, but still getting "Mmm" not "ln: Mmm". – PeterMmm Mar 23 '14 at 12:32
@PeterMmm Might be a problem with private classes - try not defining your impl inline. Which AO version are you using? Also, i believe your impl methods must be public. – mac Mar 23 '14 at 12:41
Ok, with "public" runs fine. Thanks. – PeterMmm Mar 23 '14 at 12:48

How is @Implementation used?

1 Answers1