Package ch.helvethink.odoo4java.xmlrpc

Class OdooClient

java.lang.Object
ch.helvethink.odoo4java.xmlrpc.OdooClient
All Implemented Interfaces:
OdooRpcClient
public class OdooClient extends Object implements OdooRpcClient
Abstraction of Odoo's XML-RPC API

  • Field Details

    • LOG

      public static final org.slf4j.Logger LOG
      Simple logger

  • Constructor Details

    • OdooClient

      public OdooClient(String instanceUrl, String dbName, String username, String password) throws MalformedURLException, org.apache.xmlrpc.XmlRpcException
      Constructor with direct connection
      Parameters:
      instanceUrl - The odoo Instance URL
      dbName - The odoo DB Name
      username - The Odoo username when authenticating
      password - The Odoo password when authenticating
      Throws:
      MalformedURLException - when URI is not valid
      org.apache.xmlrpc.XmlRpcException - when an error occurs with the XML-RPC API

    • OdooClient

      public OdooClient(String instanceUrl, String dbName, String username, String password, boolean mustConnect) throws MalformedURLException
      Constructor that initializes the Common API XML-RPC client
      Parameters:
      instanceUrl - The odoo Instance URL
      dbName - The odoo DB Name
      username - The Odoo username when authenticating
      password - The Odoo password when authenticating
      mustConnect - - describes if we must try to connect or not
      Throws:
      MalformedURLException - when URI is not valid

    • OdooClient

      public OdooClient(OdooXmlRpcClient commonClient, String instanceUrl, String dbName, String username, String password, boolean mustConnect) throws MalformedURLException
      Constructor with all fields
      Parameters:
      commonClient - - The common XML-RPC API client
      instanceUrl - The odoo Instance URL
      dbName - The odoo DB Name
      username - The Odoo username when authenticating
      password - The Odoo password when authenticating
      mustConnect - - describes if we must try to connect or not
      Throws:
      MalformedURLException - when URI is not valid

  • Method Details

    • getVersion

      public String getVersion()
      Retrieve Version from the Odoo Server
      Returns:
      Version like "17.0"

    • getAllModels

      public List<Map<String,Object>> getAllModels(String packageName) throws org.apache.xmlrpc.XmlRpcException
      Retrieve all Odoo models of the Odoo instance we're connected to
      Parameters:
      packageName - - allows to filter the names of models we want to retrieve
      Returns:
      List of Odoo models with fields like "description", "name", "access_ids", ...
      Throws:
      org.apache.xmlrpc.XmlRpcException - when an error occurs with the XML-RPC API

    • getFields

      public Map<String,Map<String,Object>> getFields(String modelName) throws org.apache.xmlrpc.XmlRpcException
      Get fields From Odoo, for a given model
      Parameters:
      modelName - The model we want to inspect
      Returns:
      The list of fields as a Map containing the following information: string, help, type, and relation
      Throws:
      org.apache.xmlrpc.XmlRpcException - when an error occurs with the XML-RPC API

    • findByNames

      public <T extends OdooObj> List<T> findByNames(Class<T> classToConvert, List<String> names)
      Find a list of object from names
      Type Parameters:
      T - The type of objects to return
      Parameters:
      classToConvert - The type of objects
      names - The "name" value of objects we're looking for
      Returns:
      List of found objects

    • findByCriteria

      public <T extends OdooObj> List<T> findByCriteria(int limit, Class<T> classToConvert, String... criteria)
      Specified by:
      findByCriteria in interface OdooRpcClient

    • findByCriteria

      public <T extends OdooObj> List<T> findByCriteria(int limit, int page, Class<T> classToConvert, String... criteria)
      Specified by:
      findByCriteria in interface OdooRpcClient

    • countByCriteria

      public int countByCriteria(Class<? extends OdooObj> objectType, String... criteria)
      Specified by:
      countByCriteria in interface OdooRpcClient

    • findByCriteria

      public <T extends OdooObj> List<T> findByCriteria(int limit, int page, String sortByField, Class<T> classToConvert, String... criteria)
      Specified by:
      findByCriteria in interface OdooRpcClient

    • findObjectById

      public <T extends OdooObj> T findObjectById(OdooId idToFetch, Class<T> classToConvert)
      Specified by:
      findObjectById in interface OdooRpcClient

    • findListByIdsInt

      public <T extends OdooObj> List<T> findListByIdsInt(List<Integer> idsToFetch, Class<T> classToConvert)
      Specified by:
      findListByIdsInt in interface OdooRpcClient

    • findListByIds

      public <T extends OdooObj> List<T> findListByIds(List<OdooId> idsToFetch, Class<T> classToConvert)
      Specified by:
      findListByIds in interface OdooRpcClient