# CLAUDE.md - AI Assistant Guide for CodeLibs CoreLib

Java 21 utility library. Maven build system, Apache License 2.0.

## Repository Structure

```
src/main/java/org/codelibs/core/
├── beans/       # Bean manipulation & introspection (converter/, factory/, impl/, util/)
├── collection/  # Enhanced collections (LruHashMap, CaseInsensitiveMap)
├── concurrent/  # Concurrency utilities
├── convert/     # Type conversion (*ConversionUtil)

    static {
        initialize();
    }

    /**
     * Returns a {@link BeanDesc}.
     *
     * @param clazz
     *            the Bean class. Must not be {@literal null}
     * @return {@link BeanDesc}
     */
    public static BeanDesc getBeanDesc(final Class<?> clazz) {
        assertArgumentNotNull("clazz", clazz);

        if (!initialized) {

        if (labelTypeHelper != null) {
            labelTypeHelper.refresh(getLabelTypeList());
        }
    }

    /**
     * Set up list conditions.
     *
     * @param cb The condition bean.
     * @param labelTypePager The pager for label types.
     */
    protected void setupListCondition(final LabelTypeCB cb, final LabelTypePager labelTypePager) {
        if (StringUtil.isNotBlank(labelTypePager.name)) {

            throw e;
        }
    }

    /**
     * Sets up the search conditions for user list queries based on pager criteria.
     * Configures the condition bean with search filters and ordering.
     *
     * @param cb the condition bean for the user query
     * @param userPager the pager containing search criteria
     */
    protected void setupListCondition(final UserCB cb, final UserPager userPager) {

     * Sets up the search conditions for the related query list based on the pager parameters.
     * This method configures wildcard searches for term and queries fields, and sets up ordering.
     *
     * @param cb the condition bean for building the query
     * @param relatedQueryPager the pager containing search parameters
     */
    protected void setupListCondition(final RelatedQueryCB cb, final RelatedQueryPager relatedQueryPager) {

            userBhv.insertOrUpdate(entity);
        });
    }

    /**
     * Sets up the list condition for the role query.
     * @param cb The role condition bean.
     * @param rolePager The role pager.
     */
    protected void setupListCondition(final RoleCB cb, final RolePager rolePager) {
        if (rolePager.id != null) {

    }

    /**
     * Creates search conditions for search log queries based on pager criteria.
     *
     * @param pager The search log pager containing filter criteria
     * @param cb The search log condition bean to configure
     */
    private void createSearchLogCondition(final SearchLogPager pager, final SearchLogCB cb) {
        if (StringUtil.isNotBlank(pager.queryId)) {
            cb.query().setQueryId_Term(pager.queryId);

        boostDocumentRuleBhv.delete(boostDocumentRule, op -> op.setRefreshPolicy(Constants.TRUE));

    }

    /**
     * Sets up search conditions for boost document rule list queries.
     * @param cb The condition bean for the query.
     * @param boostDocumentRulePager The pager containing search criteria.
     */
    protected void setupListCondition(final BoostDocumentRuleCB cb, final BoostDocPager boostDocumentRulePager) {

            cb.fetchFirst(fessConfig.getPagePathMappingMaxFetchSizeAsInteger());
        });
    }

    /**
     * Sets up list condition for path mapping search.
     *
     * @param cb the condition bean
     * @param pathMappingPager the path mapping pager
     */
    protected void setupListCondition(final PathMappingCB cb, final PathMapPager pathMappingPager) {
        if (StringUtil.isNotBlank(pathMappingPager.regex)) {

     *
     * @param query the search query string
     * @param params the search request parameters including pagination, filters, etc.
     * @param userBean the optional user bean for access control and personalization
     * @return the search result containing matched documents and metadata
     */