public function save( $whereAddOnly = false )
Este método é utilizado para inserir ou atualizar um registro, dependendo da situação em que o mesmo se encontra. Por exemplo: se você acabou de recuperá-lo do seu banco para realizar uma alteração, quando o método save for invocado, ele executará um update no banco de dados, pois o seu objeto possui uma chave primária com algum valor.
Caso o objeto seja novo, sem um valor definido na chave primária, e a chave primária for auto-incrementável, ele executará um insert no banco.
Para que Lumine reconheça uma classe que tenha uma chave primária auto-incrementável, é necessário declarar na parte de opções do campo o atributo autoincrement = true. Exemplo de recuperação do banco e atualizar utilizando o método save: