# OSGi New Document Factory

> Implement a new document factory base class (MappedDocumentFactory class and IMappedDocumentFactory interface).

**Goal:** Development

**Developer:** Hengsin ([talk](https://wiki.idempiere.org/en/User_talk:Hengsin))

**Description:**
**Usage:**

With following Doc class:

```java
public class MyDocInOut extends Doc_InOut {
   public MyDocInOut(MAcctSchema as, ResultSet rs, String trxName) {
	super(as, rs, trxName);
   }
}
```

:::note
`Doc_InOut` and `DocManager` are in the `org.compiere.acct` package in iDempiere 9 to 13. In the latest development branch (`master`) they are in `org.idempiere.acct.doc`. Use the package of the iDempiere version you build against.
:::

Developer can use one of the following approach:

1. At plugin Activator start method, register the document class.

```java
public void start(BundleContext context) throws Exception {
  IMappedDocumentFactory factory = Core.getMappedDocumentFactory();
  factory.addMapping(null, MInOut.Table_Name, (p) -> new MyDocInOut(p.as, p.rs, p.trxName));
  //need to reset cache if you are replacing doc classes from core
  CacheMgt.get().reset(DocManager.IDOC_FACTORY_CACHE_TABLE_NAME);
}
```

2. Create an osgi component, at the bind method for the IMappedDocumentFactory service.
```java
public void bindService(IMappedDocumentFactory factory) {
  factory.addMapping(null, MInOut.Table_Name, (p) -> new MyDocInOut(p.as, p.rs, p.trxName));
  //need to reset cache if you are replacing doc classes from core
  CacheMgt.get().reset(DocManager.IDOC_FACTORY_CACHE_TABLE_NAME);
}
```

3. Create a subclass of MappedDocumentFactory, register as IDocFactory service (DO NOT register as IMappedDocumentFactory service).
```java
public class MyDocFactory extends MappedDocumentFactory {
  public MyDocFactory() {
     addMapping(null, MInOut.Table_Name, (p) -> new MyDocInOut(p.as, p.rs, p.trxName));
     //need to reset cache if you are replacing doc classes from core
     CacheMgt.get().reset(DocManager.IDOC_FACTORY_CACHE_TABLE_NAME);
  }
}
```
**Technical Info:** [IDEMPIERE-4695](https://idempiere.atlassian.net/browse/IDEMPIERE-4695)