Package io.openems.backend.metadata.odoo

Class OdooMetadata

java.lang.Object

io.openems.backend.common.component.AbstractOpenemsBackendComponent

io.openems.backend.common.metadata.AbstractMetadata

io.openems.backend.metadata.odoo.OdooMetadata

All Implemented Interfaces:

Mailer, Metadata, org.osgi.service.event.EventHandler

public class OdooMetadata
extends AbstractMetadata
implements Metadata, Mailer, org.osgi.service.event.EventHandler

Nested Class Summary

Nested classes/interfaces inherited from interface io.openems.backend.common.metadata.Metadata

Metadata.Events

Field Summary

Fields

Modifier and Type	Field	Description
protected OdooHandler	odooHandler
protected PostgresHandler	postgresHandler

Constructor Summary

Constructors

Constructor	Description
OdooMetadata()

Method Summary

Modifier and Type	Method	Description
void	addEdgeToUser(User user, Edge edge)	Assigns Edge to current user.
User	authenticate(String sessionId)	Tries to authenticate at the Odoo server using a sessionId from a cookie.
User	authenticate(String username, String password)	Authenticates the User by username and password.
EdgeHandler	edge()	Handles operations with Edge.
Collection<Edge>	getAllOfflineEdges()	Gets all Offline-Edges.
Optional<Edge>	getEdge(String edgeId)	Get an Edge by its unique Edge-ID.
Optional<Edge>	getEdgeBySetupPassword(String setupPassword)	Get an Edge by Edge-SetupPassword.
Optional<String>	getEdgeIdForApikey(String apikey)	Gets the Edge-ID for an API-Key, i.e.
org.osgi.service.event.EventAdmin	getEventAdmin()	Returns an EventAdmin, used by Edge objects.
OdooHandler	getOdooHandler()	Gets the OdooHandler.
Map<String,Role>	getPageDevice(User user, GetEdgesRequest.PaginationOptions paginationOptions)	Gets a map of Edge-IDs with the role of the given user.
PostgresHandler	getPostgresHandler()	Gets the PostgresHandler.
Role	getRoleForEdge(User user, String edgeId)	Gets the Role for a edge of the current user.
Optional<String>	getSerialNumberForEdge(Edge edge)	Get serial number for the given Edge.
byte[]	getSetupProtocol(User user, int setupProtocolId)	Returns the Setup Protocol PDF for the given id.
com.google.gson.JsonObject	getSetupProtocolData(User user, String edgeId)	Return the Setup Protocol data as a JsonObject.
Optional<User>	getUser(String userId)	Gets the User for the given User-ID.
List<AlertingSetting>	getUserAlertingSettings(String edgeId)	Gets all the alerting settings for given edge id.
AlertingSetting	getUserAlertingSettings(String edgeId, String userId)	Gets the alerting settings for given edge id and userId.
Map<String,Object>	getUserInformation(User user)	Gets information about the given user User.
void	handleEvent(org.osgi.service.event.Event event)
void	logError(org.slf4j.Logger log, String message)	Log an error message including the Component ID.
void	logInfo(org.slf4j.Logger log, String message)	Log an info message including the Component ID.
void	logout(User user)	Closes a session for a User.
void	logWarn(org.slf4j.Logger log, String message)	Log a warn message including the Component ID.
void	registerUser(com.google.gson.JsonObject jsonObject, OpenemsOEM.Manufacturer oem)	Register a user.
void	sendMail(ZonedDateTime sendAt, String template, com.google.gson.JsonElement params)	Send alerting mail at stamp to users.
void	setUserAlertingSettings(User user, String edgeId, List<AlertingSetting> users)	Sets the alerting settings for the given list of users.
void	setUserInformation(User user, com.google.gson.JsonObject jsonObject)	Update the given user User with new information JsonObject.
int	submitSetupProtocol(User user, com.google.gson.JsonObject jsonObject)	Submit the installation assistant protocol.
void	updateUserLanguage(User user, Language language)	Update language from given user.

Methods inherited from class io.openems.backend.common.metadata.AbstractMetadata

isInitialized, setInitialized

Methods inherited from class io.openems.backend.common.component.AbstractOpenemsBackendComponent

getName, logDebug, logDebug, logError, logInfo, logWarn

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.openems.backend.common.metadata.Metadata

addEdgeToUser, getEdgeOrError, isInitialized

Field Details

odooHandler

protected OdooHandler odooHandler

postgresHandler

protected PostgresHandler postgresHandler

Constructor Details

OdooMetadata

public OdooMetadata()

Method Details

authenticate

public User authenticate(String username,
 String password)
                  throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Authenticates the User by username and password.

Specified by:

authenticate in interface Metadata

Parameters:

username - the Username

password - the Password

Returns:

the User

Throws:

OpenemsError.OpenemsNamedException - on error

authenticate

public User authenticate(String sessionId)
                  throws OpenemsError.OpenemsNamedException

Tries to authenticate at the Odoo server using a sessionId from a cookie.

Specified by:

authenticate in interface Metadata

Parameters:

sessionId - the Session-ID

Returns:

the User

Throws:

OpenemsException - on error

OpenemsError.OpenemsNamedException - on error

logout

public void logout(User user)

Description copied from interface: Metadata

Closes a session for a User.

Specified by:

logout in interface Metadata

Parameters:

user - the User

getEdgeIdForApikey

public Optional<String> getEdgeIdForApikey(String apikey)

Description copied from interface: Metadata

Gets the Edge-ID for an API-Key, i.e. authenticates the API-Key.

Specified by:

getEdgeIdForApikey in interface Metadata

Parameters:

apikey - the API-Key

Returns:

the Edge-ID or Empty

getEdgeBySetupPassword

public Optional<Edge> getEdgeBySetupPassword(String setupPassword)

Description copied from interface: Metadata

Get an Edge by Edge-SetupPassword.

Specified by:

getEdgeBySetupPassword in interface Metadata

Parameters:

setupPassword - to find Edge

Returns:

Edge as a Optional

getEdge

public Optional<Edge> getEdge(String edgeId)

Description copied from interface: Metadata

Get an Edge by its unique Edge-ID.

Specified by:

getEdge in interface Metadata

Parameters:

edgeId - the Edge-ID

Returns:

the Edge as Optional

getUser

public Optional<User> getUser(String userId)

Description copied from interface: Metadata

Gets the User for the given User-ID.

Specified by:

getUser in interface Metadata

Parameters:

userId - the User-ID

Returns:

the User, or Empty

getAllOfflineEdges

public Collection<Edge> getAllOfflineEdges()

Description copied from interface: Metadata

Gets all Offline-Edges.

Specified by:

getAllOfflineEdges in interface Metadata

Returns:

collection of Edges.

getOdooHandler

public OdooHandler getOdooHandler()

Gets the OdooHandler.

Returns:

the OdooHandler

getPostgresHandler

public PostgresHandler getPostgresHandler()

Gets the PostgresHandler.

Returns:

the PostgresHandler

logInfo

public void logInfo(org.slf4j.Logger log,
 String message)

Description copied from class: AbstractOpenemsBackendComponent

Log an info message including the Component ID.

Overrides:

logInfo in class AbstractOpenemsBackendComponent

Parameters:

log - the Logger that is used for writing the log

message - the Info-message

logWarn

public void logWarn(org.slf4j.Logger log,
 String message)

Description copied from class: AbstractOpenemsBackendComponent

Log a warn message including the Component ID.

Overrides:

logWarn in class AbstractOpenemsBackendComponent

Parameters:

log - the Logger that is used for writing the log

message - the Warn-message

logError

public void logError(org.slf4j.Logger log,
 String message)

Description copied from class: AbstractOpenemsBackendComponent

Log an error message including the Component ID.

Overrides:

logError in class AbstractOpenemsBackendComponent

Parameters:

log - the Logger that is used for writing the log

message - the Error-message

addEdgeToUser

public void addEdgeToUser(User user,
 Edge edge)
                   throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Assigns Edge to current user.

If assignment fails, an OpenemsNamedException is thrown.

Specified by:

addEdgeToUser in interface Metadata

Parameters:

user - The User

edge - The Edge

Throws:

OpenemsError.OpenemsNamedException - on error

getUserInformation

public Map<String,Object> getUserInformation(User user)
                                      throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Gets information about the given user User.

Specified by:

getUserInformation in interface Metadata

Parameters:

user - User to read information

Returns:

Map about the user

Throws:

OpenemsError.OpenemsNamedException - on error

setUserInformation

public void setUserInformation(User user,
 com.google.gson.JsonObject jsonObject)
                        throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Update the given user User with new information JsonObject.

Specified by:

setUserInformation in interface Metadata

Parameters:

user - User to update

jsonObject - JsonObject information about the user

Throws:

OpenemsError.OpenemsNamedException - on error

getSetupProtocol

public byte[] getSetupProtocol(User user,
 int setupProtocolId)
                        throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Returns the Setup Protocol PDF for the given id.

Specified by:

getSetupProtocol in interface Metadata

Parameters:

user - User the current user

setupProtocolId - the setup protocol id to search

Returns:

the Setup Protocol PDF as a byte array

Throws:

OpenemsError.OpenemsNamedException - on error

getSetupProtocolData

public com.google.gson.JsonObject getSetupProtocolData(User user,
 String edgeId)
                                                throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Return the Setup Protocol data as a JsonObject.

Specified by:

getSetupProtocolData in interface Metadata

Parameters:

user - User the current user

edgeId - the Edge ID to get the data

Returns:

Setup Protocol as a JsonObject

Throws:

OpenemsError.OpenemsNamedException - on error

submitSetupProtocol

public int submitSetupProtocol(User user,
 com.google.gson.JsonObject jsonObject)
                        throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Submit the installation assistant protocol.

Specified by:

submitSetupProtocol in interface Metadata

Parameters:

user - User the current user

jsonObject - JsonObject the setup protocol

Returns:

id of created setup protocol

Throws:

OpenemsError.OpenemsNamedException - on error

registerUser

public void registerUser(com.google.gson.JsonObject jsonObject,
 OpenemsOEM.Manufacturer oem)
                  throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Register a user.

Specified by:

registerUser in interface Metadata

Parameters:

jsonObject - JsonObject that represents an user

oem - OEM name

Throws:

OpenemsError.OpenemsNamedException - on error

updateUserLanguage

public void updateUserLanguage(User user,
 Language language)
                        throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Update language from given user.

Specified by:

updateUserLanguage in interface Metadata

Parameters:

user - User the current user

language - to set language

Throws:

OpenemsError.OpenemsNamedException - on error

getEventAdmin

public org.osgi.service.event.EventAdmin getEventAdmin()

Description copied from interface: Metadata

Returns an EventAdmin, used by Edge objects.

Specified by:

getEventAdmin in interface Metadata

Returns:

EventAdmin

handleEvent

public void handleEvent(org.osgi.service.event.Event event)

Specified by:

handleEvent in interface org.osgi.service.event.EventHandler

edge

public EdgeHandler edge()

Description copied from interface: Metadata

Handles operations with Edge.

To be completed. This should eventually replace Edge.

Specified by:

edge in interface Metadata

Returns:

an EdgeHandler

getSerialNumberForEdge

public Optional<String> getSerialNumberForEdge(Edge edge)

Description copied from interface: Metadata

Get serial number for the given Edge.

Specified by:

getSerialNumberForEdge in interface Metadata

Parameters:

edge - Edge to search for serial number

Returns:

Serial number or empty Optional

sendMail

public void sendMail(ZonedDateTime sendAt,
 String template,
 com.google.gson.JsonElement params)

Description copied from interface: Mailer

Send alerting mail at stamp to users.

Specified by:

sendMail in interface Mailer

Parameters:

sendAt - is dateTime at which to send

template - mail template to use

params - mail data

getUserAlertingSettings

public List<AlertingSetting> getUserAlertingSettings(String edgeId)
                                              throws OpenemsException

Description copied from interface: Metadata

Gets all the alerting settings for given edge id.

Specified by:

getUserAlertingSettings in interface Metadata

Parameters:

edgeId - the Edge ID

Returns:

List of AlertingSetting

Throws:

OpenemsException - on error

getUserAlertingSettings

public AlertingSetting getUserAlertingSettings(String edgeId,
 String userId)
                                        throws OpenemsException

Description copied from interface: Metadata

Gets the alerting settings for given edge id and userId.

Specified by:

getUserAlertingSettings in interface Metadata

Parameters:

edgeId - the Edge ID

userId - the User ID

Returns:

List of UserRoleDelayTime

Throws:

OpenemsException - on error

setUserAlertingSettings

public void setUserAlertingSettings(User user,
 String edgeId,
 List<AlertingSetting> users)
                             throws OpenemsException

Description copied from interface: Metadata

Sets the alerting settings for the given list of users.

Specified by:

setUserAlertingSettings in interface Metadata

Parameters:

user - User the current user

edgeId - the Edge-ID

users - list of users to update

Throws:

OpenemsException - on error

getPageDevice

public Map<String,Role> getPageDevice(User user,
 GetEdgesRequest.PaginationOptions paginationOptions)
                               throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Gets a map of Edge-IDs with the role of the given user.

Specified by:

getPageDevice in interface Metadata

Parameters:

user - User the current user

paginationOptions - the options of the requesting page

Returns:

the role to the Edge-IDs

Throws:

OpenemsError.OpenemsNamedException - on error

getRoleForEdge

public Role getRoleForEdge(User user,
 String edgeId)
                    throws OpenemsError.OpenemsNamedException

Description copied from interface: Metadata

Gets the Role for a edge of the current user.

Specified by:

getRoleForEdge in interface Metadata

Parameters:

user - User the current user

edgeId - the Edge-ID

Returns:

the role to the edge

Throws:

OpenemsError.OpenemsNamedException - on error