2.1.name mapping rule

Use xorm.IMapper interface to set the name mapping rule. There are three rules: SnakeMapper, SameMapper, and GonicMapper.

  • SnakeMapper inserts an _ (underscore) between each word (Capital Case) to get the table name or column name.
  • SameMapper uses the same name between the struct and table.
  • GonicMapper is basically the same as SnakeMapper, but doesn’t insert an underscore between commonly used acronyms. For example ID is converted to id in GonicMapper, but ID is converted to i_d in SnakeMapper.

SnakeMapper is the default. You can change it use SetMapper.


And you should notice:

  • If you want to use other mapping rule, implement IMapper
  • Tables’s mapping rule could be different from Columns’:

When a struct auto mapping to a database’s table, the below table describes how they change to each other:

go type's kind value method xorm type
implemented Conversion Conversion.ToDB / Conversion.FromDB Text
int, int8, int16, int32, uint, uint8, uint16, uint32 Int
int64, uint64BigInt
complex64, complex128 json.Marshal / json.UnMarshal Varchar(64)
array, slice, map except []uint8 json.Marshal / json.UnMarshal Text
bool1 or 0Bool
cascade structprimary key field valueBigInt
structjson.Marshal / json.UnMarshalText
Others Text