Spring数据国际化最佳实践

Posted 2023-02-26

【中文标题】Spring数据国际化最佳实践

【英文标题】：Spring data internationalization best practice

【发布时间】：2014-04-22 07:30:14

【问题描述】：

我有一个带有 spring 数据、jpa 和 hibernate 的 spring mvc 项目。我有一个多语言数据库。我设计了我的数据库和实体。我正在寻找一种按语言查询我的表的最佳实践。我是否必须编写自定义 jpa 查询，或者是否有通用方法来查询我的表。

如果我在数据库或实体设计上有错误，请警告我。

数据库：

CREATE TABLE translation (
  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
  PRIMARY KEY (id));

CREATE TABLE translation_text (
  translation_id BIGINT UNSIGNED NOT NULL,
  lang VARCHAR(2),
  text VARCHAR(1000));

ALTER TABLE translation_text
ADD FOREIGN KEY (translation_id)
REFERENCES translation(id);

CREATE TABLE category (
  id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT,
  category_name BIGINT UNSIGNED NOT NULL,
  PRIMARY KEY (id));

ALTER TABLE category
ADD FOREIGN KEY (category_name)
REFERENCES translation(id);

本地化字符串实体：

@Embeddable
public class LocalizedString 

    private String lang;
    private String text;

    //Constructors and getter setters...

多语言字符串实体：

@Entity
@Table(name = "translation")
public class MultilingualString 

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id")
    private long id;

    @ElementCollection(fetch = FetchType.EAGER)
    @MapKeyColumn(name = "lang_key")
    @CollectionTable(name = "translation_text", joinColumns = @JoinColumn(name = "translation_id"))
    private final Map<String, LocalizedString> map = new HashMap<String, LocalizedString>();

    public MultilingualString() 
    

    public MultilingualString(String lang, String text) 
        addText(lang, text);
    

    public void addText(String lang, String text) 
        map.put(lang, new LocalizedString(lang, text));
    

    public String getText(String lang) 
        if (map.containsKey(lang)) 
            return map.get(lang).getText();
        
        return null;
    

    public long getId() 
        return id;
    

    public void setId(long id) 
        this.id = id;
    

类别实体：

@Entity
@Table(name = "category")
@Cache(usage = CacheConcurrencyStrategy.NONSTRICT_READ_WRITE)
public class Category extends BaseEntity<Long> implements Serializable 

    private static final long serialVersionUID = 1L;

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")
    private Long id;

    @ManyToOne(cascade=CascadeType.ALL)
    @JoinColumn(name="category_name")
    private final MultilingualString categoryName = new MultilingualString();


    public Category(String lang, String categoryName) 
        this.categoryName.addText(lang, categoryName);
    
    public Category() 
        super();
    

    @Override
    public Long getId() 
        return id;
    

    public void setId(Long id) 
        this.id = id;
    

    public String getCategoryName(String lang) 
        return this.categoryName.getText(lang);
    

    public void setCategoryName(String lang, String categoryName) 
        this.categoryName.addText(lang, categoryName);
    

类别存储库：

public interface CategoryRepository extends JpaRepository<Category, Long>

如何将语言参数传递给CategoryRepository 并获取该语言的特定数据？

【问题讨论】：

我只是想知道你为什么需要“@Embeddable”，你已经将它映射到“MultilingualString”中，我可能会改变的一件事是“@JoinColumn”来映射增量ID而不是字符串

@fyelci 你找到解决办法了吗？

检查***.com/questions/10693508/… 和vertabelo.com/blog/technical-articles/…。数据库 i18n 可以通过多种方式完成，您可以通过搜索找到它们;)

【参考方案1】：

请注意，国际化最佳实践，尤其是在数据库设计中，独立于 Spring 数据。

特别是对于在数据库模式中使用多语言，我早在 2010 年就设计了一些东西，试图跟上可用的标准，如用于表示语言的 ISO 639 - 例如众所周知的语言短名称，如 en、de、es、 fr, ... 在那里是标准化的。

对于其他人感兴趣的情况，我还使用ISO 3166 作为国家代码，以及ISO 4217 作为货币代码。

因为一张图片说了一千多个字，这里是我的数据库设计的部分截图（我称之为 EarthDB - 有一天会成为开源）：

您可以简单地看到语言表使用 ISO 639-3 代码作为主键（您不需要整数，因为在访问其他表时使用 iso 代码也更直观）并且有一些更多 ISO639 内容以确保完整性。

然后，language_names 表会保存以（希望）所有语言编写的所有语言的名称 - 因此您可以简单地获取以他们自己的语言或简单地用英语、德语等编写的所有语言名称。

当关注国家及其国家名称（以各种语言编写）时，可以看到如何更广泛地使用此基础的概念。货币及其货币名称以及您可能需要国际化的所有其他类型的东西也是如此。

因此，概念始终是为您的基础数据提供一个表，该表仅具有语言独立值。在此基础数据旁边，您有一个语言依赖文本表，它充当您的基础表和语言表之间的一种 M:N 表。

因此，您的国际化基于 ISO 标准具有参考完整性；-)

最后但并非最不重要的是创建语言和语言名称表的 sql 代码：

create table LANGUAGES
(
   LANG_ISO639_3        char(3) not null comment 'ISO639 Part 3',
   LAN_LANG_ISO639_3    char(3) comment 'ISO639 Part 3',
   LANG_ISO639_2T       char(3) comment 'ISO 639 Part 2 terminology',
   LANG_ISO639_2B       char(3) comment 'ISO 639 Part 2 bibliographic',
   LANG_ISO639_1        char(2) comment 'ISO 639 Part 1',
   LANG_SCOPE           char(1) not null comment 'Scope of denotation:

     Individual languages
     Macrolanguages
     Special situations

     Collections of languages
     Dialects
     Reserved for local use

     http://www.sil.org/iso639-3/scope.asp
     ',
   LANG_TYPE            char(1) not null comment 'Type of language:

            Living languages
            Extinct languages
            Ancient languages
            Historic languages
            Constructed languages

            http://www.sil.org/iso639-3/types.asp',
   primary key (LANG_ISO639_3)
);

alter table LANGUAGES comment 'ISO 639 table http://www.sil.org/iso639-3/codes';


create table LANGUAGE_NAMES
(
   LANG_ISO639_3        char(3) not null comment 'ISO639 Part 3',
   LAN_LANG_ISO639_3    char(3) not null comment 'ISO639 Part 3',
   LNAMES_NAME          national varchar(64) not null comment 'Language name',
   LNAMES_INAME         national varchar(64) comment 'Inverted language name',
   primary key (LANG_ISO639_3, LAN_LANG_ISO639_3)
);

alter table LANGUAGE_NAMES comment 'ISO 639 language names written in given language.';