Как сделать уникальные значения в таблице

Уникальные значения в таблице: полный обзор подходов

Вопрос о уникальности данных — один из фундаментальных в проектировании баз данных и разработке на Java. Рассмотрю несколько подходов, от базовых до продвинутых.

На уровне базы данных

UNIQUE constraint

Это основной и самый надёжный способ. Добавляем ограничение на уровне БД:

CREATE TABLE users (
    id BIGINT PRIMARY KEY,
    email VARCHAR(255) NOT NULL,
    username VARCHAR(100) NOT NULL,
    UNIQUE(email),
    UNIQUE(username)
);

Или через ALTER:

ALTER TABLE users ADD CONSTRAINT uk_email UNIQUE(email);

Преимущества:

• Гарантирует уникальность на уровне БД (самое важное!)
• Работает независимо от приложения
• Производительность — индекс создаётся автоматически
• Защита от race conditions

PRIMARY KEY

Это частный случай UNIQUE, где значение не может быть NULL:

CREATE TABLE posts (
    id UUID PRIMARY KEY,
    slug VARCHAR(255) NOT NULL UNIQUE,
    title VARCHAR(255)
);

На уровне Java приложения

HashSet для проверки дубликатов

Если нужно проверить уникальность в памяти:

public class UserService {
    public boolean hasDuplicates(List<User> users) {
        Set<String> emails = new HashSet<>();
        for (User user : users) {
            if (!emails.add(user.getEmail())) {
                return true; // Найден дубликат
            }
        }
        return false;
    }

    // Или через Stream API
    public boolean hasDuplicatesStream(List<User> users) {
        return users.size() > 
               users.stream()
                   .map(User::getEmail)
                   .collect(Collectors.toSet())
                   .size();
    }
}

LinkedHashSet для сохранения порядка

Если важен порядок элементов:

Set<String> uniqueEmails = new LinkedHashSet<>(users.stream()
    .map(User::getEmail)
    .collect(Collectors.toList()));

TreeSet для сортировки

Для отсортированных уникальных значений:

Set<String> sortedUnique = users.stream()
    .map(User::getEmail)
    .collect(Collectors.toCollection(TreeSet::new));

Валидация в JPA/Hibernate

Аннотация @Column(unique = true)

@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private String id;

    @Column(unique = true, nullable = false)
    private String email;

    @Column(unique = true, nullable = false)
    private String username;
}

Важно: эта аннотация генерирует миграцию, но не валидирует на уровне приложения до сохранения.

Кастомная аннотация @Unique

Для более гибкой валидации:

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = UniqueValidator.class)
public @interface Unique {
    String message() default "Значение должно быть уникальным";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    String fieldName() default "";
}

public class UniqueValidator implements ConstraintValidator<Unique, Object> {
    @Autowired
    private UserRepository userRepository;

    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        if (value == null) return true;
        return !userRepository.existsByEmail((String) value);
    }
}

@Entity
public class User {
    @Unique(fieldName = "email")
    private String email;
}

Обработка ошибок при нарушении UNIQUE

public class UserService {
    @Autowired
    private UserRepository userRepository;

    public User createUser(User user) throws DuplicateEmailException {
        try {
            return userRepository.save(user);
        } catch (DataIntegrityViolationException e) {
            throw new DuplicateEmailException("Email уже зарегистрирован");
        }
    }
}

Composite UNIQUE (несколько полей)

CREATE TABLE user_ratings (
    user_id BIGINT,
    product_id BIGINT,
    rating INT,
    UNIQUE(user_id, product_id)
);

В JPA:

@Entity
@Table(
    name = "user_ratings",
    uniqueConstraints = {
        @UniqueConstraint(columnNames = {"user_id", "product_id"})
    }
)
public class UserRating {
    // поля
}

Best Practices

1. Всегда делай UNIQUE на уровне БД — это критично
2. Добавляй валидацию в приложение — для UX и раннего обнаружения
3. Используй индексы — для production данных
4. Обрабатывай исключения — DataIntegrityViolationException
5. Для больших данных — используй HashSet, а не List.contains()
6. Документируй ограничения — это контракт данных

Уникальность — не опция, а обязательный атрибут хорошей архитектуры!