feat(converter): 实现通用枚举转换器和供应商类型转换器

添加EnumEntityStringConverter作为通用枚举转换基类
实现VendorTypeStringConverter用于供应商类型本地化转换
在VendorTypeService中添加findByLocaleAndValue方法支持转换器
优化ComboBoxUtils的绑定逻辑使其支持可选属性
新增VendorCatalogService提供供应商目录CRUD功能

client/src/main/java/com/ecep/contract/controller/ComboBoxUtils.java

@@ -124,6 +124,11 @@ public class ComboBoxUtils {
         }
         list.addAll(queryService.findAll());
         comboBox.setItems(list);
+
+        EntityStringConverter<T> converter = new EntityStringConverter<>(list);
+        comboBox.setConverter(converter);
+
+        if (property != null) {
             // 从ComboBox选择到property的单向绑定
             comboBox.getSelectionModel().selectedItemProperty().addListener((observable, oldValue, newValue) -> {
                 property.setValue(newValue != null ? newValue.getId() : null);
@@ -139,8 +144,7 @@ public class ComboBoxUtils {
                         .findFirst()
                         .ifPresent(comboBox.getSelectionModel()::select);
             });
-        EntityStringConverter<T> converter = new EntityStringConverter<>(list);
-        comboBox.setConverter(converter);
+
             // 初始化ComboBox的值
             if (property.getValue() != null) {
                 list.stream()
@@ -149,6 +153,7 @@ public class ComboBoxUtils {
                         .ifPresent(comboBox.getSelectionModel()::select);
             }
         }
+    }
 
     public static <T extends IdentityEntity & NamedEntity> void initialComboBox(
             ComboBox<T> comboBox, Property<T> property, List<T> dataSet, boolean hasNull) {

client/src/main/java/com/ecep/contract/converter/EnumEntityStringConverter.java

@@ -1,4 +1,18 @@
 package com.ecep.contract.converter;
 
-public class EnumEntityStringConverter {
+import com.ecep.contract.model.BaseEnumEntity;
+import javafx.util.StringConverter;
+
+public class EnumEntityStringConverter<E extends Enum<?>, T extends BaseEnumEntity<E>> extends StringConverter<T> {
+
+    @Override
+    public String toString(T object) {
+        return object == null ? "" : object.getValue();
+    }
+
+    @Override
+    public T fromString(String string) {
+        return null;
+        // return service.findByName(string);
+    }
 }

client/src/main/java/com/ecep/contract/converter/VendorTypeStringConverter.java

@@ -1,4 +1,24 @@
 package com.ecep.contract.converter;
 
-public class VendorTypeStringConverter {
+import com.ecep.contract.Desktop;
+import com.ecep.contract.service.VendorTypeService;
+import com.ecep.contract.vo.VendorTypeLocalVo;
+import javafx.util.StringConverter;
+
+public class VendorTypeStringConverter extends StringConverter<VendorTypeLocalVo> {
+    private final VendorTypeService service;
+
+    public VendorTypeStringConverter(VendorTypeService service) {
+        this.service = service;
+    }
+
+    @Override
+    public String toString(VendorTypeLocalVo object) {
+        return object.getValue();
+    }
+
+    @Override
+    public VendorTypeLocalVo fromString(String string) {
+        return service.findByLocaleAndValue(Desktop.instance.getActiveEmployee().localeProperty().get(), string);
+    }
 }

client/src/main/java/com/ecep/contract/service/VendorTypeService.java

@@ -1,19 +1,17 @@
 package com.ecep.contract.service;
 
-import java.util.List;
-
-import org.springframework.cache.annotation.CacheConfig;
-import org.springframework.cache.annotation.CacheEvict;
-import org.springframework.cache.annotation.CachePut;
-import org.springframework.cache.annotation.Cacheable;
-import org.springframework.cache.annotation.Caching;
-import org.springframework.data.domain.Pageable;
-import org.springframework.stereotype.Service;
-
 import com.ecep.contract.VendorType;
+import com.ecep.contract.converter.VendorTypeStringConverter;
 import com.ecep.contract.util.ParamUtils;
 import com.ecep.contract.vm.VendorTypeLocalViewModel;
 import com.ecep.contract.vo.VendorTypeLocalVo;
+import javafx.util.StringConverter;
+import org.springframework.cache.annotation.*;
+import org.springframework.data.domain.Pageable;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+import java.util.Locale;
 
 @Service
 @CacheConfig(cacheNames = "vendor-type")
@@ -36,15 +34,27 @@ public class VendorTypeService extends QueryService<VendorTypeLocalVo, VendorTyp
         return super.findAll();
     }
 
-    @Caching(put = { @CachePut(key = "#p0.id"), @CachePut(key = "'type-'+#p0.type"), @CachePut(key = "'all'") })
+    @Caching(put = {@CachePut(key = "#p0.id"), @CachePut(key = "'type-'+#p0.type"), @CachePut(key = "'all'")})
     @Override
     public VendorTypeLocalVo save(VendorTypeLocalVo entity) {
         return super.save(entity);
     }
 
-    @Caching(evict = { @CacheEvict(key = "#p0.id"), @CacheEvict(key = "'type-'+#p0.type"), @CacheEvict(key = "'all'") })
+    @Caching(evict = {@CacheEvict(key = "#p0.id"), @CacheEvict(key = "'type-'+#p0.type"), @CacheEvict(key = "'all'")})
     @Override
     public void delete(VendorTypeLocalVo entity) {
         super.delete(entity);
     }
+
+    private StringConverter<VendorTypeLocalVo> stringConverter = new VendorTypeStringConverter(this);
+
+    @Override
+    public StringConverter<VendorTypeLocalVo> getStringConverter() {
+        return stringConverter;
+    }
+
+    public VendorTypeLocalVo findByLocaleAndValue(Locale locale, String string) {
+        return findAll(ParamUtils.builder().equals("lang", locale.toLanguageTag()).equals("value", string).build(), Pageable.ofSize(1))
+                .stream().findFirst().orElse(null);
+    }
 }

server/src/main/java/com/ecep/contract/ds/vendor/service/VendorCatalogService.java

@@ -1,4 +1,85 @@
 package com.ecep.contract.ds.vendor.service;
 
-public class VendorCatalogService {
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.cache.annotation.CacheConfig;
+import org.springframework.cache.annotation.CacheEvict;
+import org.springframework.cache.annotation.Cacheable;
+import org.springframework.cache.annotation.Caching;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.data.domain.Page;
+import org.springframework.data.domain.Pageable;
+import org.springframework.data.jpa.domain.Specification;
+import org.springframework.stereotype.Service;
+import org.springframework.util.StringUtils;
+
+import com.ecep.contract.IEntityService;
+import com.ecep.contract.QueryService;
+import com.ecep.contract.constant.ServiceConstant;
+import com.ecep.contract.ds.vendor.repository.VendorClassRepository;
+import com.ecep.contract.model.VendorCatalog;
+import com.ecep.contract.util.SpecificationUtils;
+import com.fasterxml.jackson.databind.JsonNode;
+
+/**
+ * 供应商目录服务类
+ * 提供对供应商目录的查询、创建、更新和删除操作
+ */
+@Lazy
+@Service
+@CacheConfig(cacheNames = "vendor-catalog")
+public class VendorCatalogService implements IEntityService<VendorCatalog>, QueryService<VendorCatalog> {
+    @Lazy
+    @Autowired
+    private VendorClassRepository repository;
+
+    @Override
+    public Page<VendorCatalog> findAll(JsonNode paramsNode, Pageable pageable) {
+        Specification<VendorCatalog> spec = null;
+        if (paramsNode.has(ServiceConstant.KEY_SEARCH_TEXT)) {
+            spec = getSpecification(paramsNode.get(ServiceConstant.KEY_SEARCH_TEXT).asText());
+        }
+
+        // field
+        spec = SpecificationUtils.andFieldEqualParam(spec, paramsNode, "name", "code", "parentId");
+        return findAll(spec, pageable);
+    }
+
+    @Cacheable(key = "#p0")
+    @Override
+    public VendorCatalog findById(Integer id) {
+        return repository.findById(id).orElse(null);
+    }
+
+    @Override
+    public Page<VendorCatalog> findAll(Specification<VendorCatalog> spec, Pageable pageable) {
+        return repository.findAll(spec, pageable);
+    }
+
+    @Override
+    public Specification<VendorCatalog> getSpecification(String searchText) {
+        if (!StringUtils.hasText(searchText)) {
+            return null;
+        }
+        return (root, query, builder) -> {
+            return builder.or(
+                    builder.like(root.get("name"), "%" + searchText + "%"),
+                    builder.like(root.get("code"), "%" + searchText + "%"));
+        };
+    }
+
+    @Caching(evict = {
+            @CacheEvict(key = "#p0.id")
+    })
+    @Override
+    public void delete(VendorCatalog entity) {
+        repository.delete(entity);
+    }
+
+    @Caching(evict = {
+            @CacheEvict(key = "#p0.id")
+    })
+    @Override
+    public VendorCatalog save(VendorCatalog entity) {
+        return repository.save(entity);
+    }
 }