« Changelog History


alpas v0.15.0 Release Notes

Release Date: 2020-02-18 // about 4 years ago

  • 🚀 This release brings even more exciting features and improvements to Alpas. Here are the highlights:

    🍱 🎉 New Features

    ✔️ Resourceful Routes

    You can create a resourceful routes for all the CRUD operations by using resources() method:
    resources<PostController>("posts").name("posts")

    ✔️ Auto Port Selection

    📄 In dev mode Alpas automatically selects the next port if the selected port is in use already. Docs.

    ✔️ Ozone Extensions

    ⚡️ Few useful methods and conventions are added in Ozone such as findOrCreate(attrs), findOne(attrs), findMany(), update(attrs), reference() etc. Docs.

    ✔️ Column Binding Conventions

    ⚡️ Also added are four new column bindings - createdAt(), updatedAt(), increments(), bigIncrements().
    📄 Docs.

    This means instead of this:

    val id by bigInt("id").autoIncrement().unsigned().primaryKey().bindTo{ it.id }val createdAt by timestamp("created\_at").nullable().useCurrent().bindTo { it.createdAt }val updatedAt by timestamp("updated\_at").nullable().useCurrent().bindTo { it.updatedAt }

    You can do this:

    val id by bigIncrements()val createdAt by createdAt()val updatedAt by updatedAt()

    ✔️ Routes reloading without re-running the app

    🐎 In dev mode, routes are now reloaded without restarting the app. For performance reason this is disabled in the prod mode.

    ✔️ Run migrations using a name property

    This allows to run migrations even from a fat jar. Very helpful in production.

    ✔️ Added basic table modification support

    You can now addColumn() and dropColumn()

    ✔️ Reference Constraint

    You can now add a reference constraint on a column:

    val userId by long("user\_id").belongsTo(Users) { it.user }.unsigned().reference { onDeleteCascade() }

    🍱 💄 Improvements

    ⚡️ 😀 Assets handling is more optimized.

    👀 😀 You can seed a database with database refresh by using --seed flag.

    🍱 😀 Improved strong typing while overriding an entity's properties in an entity factory.

    val user = from(UserFactory) { it.name to "Jane M. Doe" it.email to "[email protected]"}

    🍱 💔 Breaking Changes

    🚀 There are few but significant breaking changes in this release:

    🤦🏽‍♂️ Entity has been renamed to OzoneEntity and MigratingTable has been renamed to OzoneTable:

    // Before: interface User : Entity\<User\>// Now:interface User : OzoneEntity\<User\> { // ...// Before: companion object : Entity.Factory\<User\>// Now:companion object : OzoneEntity.Of\<User\>() }// Before: object Users : MigratingTable\<User\>// Now:object Users : OzoneTable\<User\>("users") { // ...}

    🤦🏽‍♂️ EntityFactory now takes two parameters instead of one:

    // Before: class UserFactory() : EntityFactory\<User\>()// Now:class UserFactory() : EntityFactory\<User, Users\>() { // ...}

    🤦🏽‍♂️ Methods Renamed:

    • onlyParams() method has been renamed to params()
    • paramAsString() method is now stringParam()
    • paramAsInt() is now intParam()
    • paramAsLong() is now longParam()
    • paramAsBool() is now boolParam()