Inserts a new Session record into the underling EIS (e.g. Relational database, file system, persistent cache, etc, depending on the DAO implementation).
After this method is invoked, the {@link org.apache.shiro.session.Session#getId()}method executed on the argument must return a valid session identifier. That is, the following should always be true:
Serializable id = create( session ); id.equals( session.getId() ) == true
Implementations are free to throw any exceptions that might occur due to integrity violation constraints or other EIS related errors.
@param session the {@link org.apache.shiro.session.Session} object to create in the EIS.
@return the EIS id (e.g. primary key) of the created {@code Session} object.