Class EmailQuery.Builder

java.lang.Object
cloud.opencode.base.email.query.EmailQuery.Builder
Enclosing class:
EmailQuery

public static class EmailQuery.Builder extends Object
Email Query Builder 邮件查询构建器
Since:
JDK 25, opencode-base-email V1.0.0
Author:
Leon Soo www.LeonSoo.com
  • Constructor Details

    • Builder

      public Builder()
  • Method Details

    • folder

      public EmailQuery.Builder folder(EmailFolder folder)
      Set the folder to query 设置要查询的文件夹
      Parameters:
      folder - the folder | 文件夹
      Returns:
      this builder | 构建器
    • folder

      public EmailQuery.Builder folder(String folder)
      Set the folder to query by name 根据名称设置要查询的文件夹
      Parameters:
      folder - the folder name | 文件夹名称
      Returns:
      this builder | 构建器
    • fromDate

      public EmailQuery.Builder fromDate(LocalDateTime fromDate)
      Set minimum date for emails 设置邮件最小日期
      Parameters:
      fromDate - the minimum date | 最小日期
      Returns:
      this builder | 构建器
    • toDate

      public EmailQuery.Builder toDate(LocalDateTime toDate)
      Set maximum date for emails 设置邮件最大日期
      Parameters:
      toDate - the maximum date | 最大日期
      Returns:
      this builder | 构建器
    • dateRange

      public EmailQuery.Builder dateRange(LocalDateTime fromDate, LocalDateTime toDate)
      Set date range for emails 设置邮件日期范围
      Parameters:
      fromDate - the minimum date | 最小日期
      toDate - the maximum date | 最大日期
      Returns:
      this builder | 构建器
    • from

      public EmailQuery.Builder from(String from)
      Filter by sender address 按发件人地址过滤
      Parameters:
      from - the sender address | 发件人地址
      Returns:
      this builder | 构建器
    • from

      public EmailQuery.Builder from(Set<String> from)
      Filter by multiple sender addresses 按多个发件人地址过滤
      Parameters:
      from - the sender addresses | 发件人地址列表
      Returns:
      this builder | 构建器
    • to

      public EmailQuery.Builder to(String to)
      Filter by recipient address 按收件人地址过滤
      Parameters:
      to - the recipient address | 收件人地址
      Returns:
      this builder | 构建器
    • to

      public EmailQuery.Builder to(Set<String> to)
      Filter by multiple recipient addresses 按多个收件人地址过滤
      Parameters:
      to - the recipient addresses | 收件人地址列表
      Returns:
      this builder | 构建器
    • subjectContains

      public EmailQuery.Builder subjectContains(String subject)
      Filter by subject containing text 按主题包含文本过滤
      Parameters:
      subject - the text to search in subject | 要在主题中搜索的文本
      Returns:
      this builder | 构建器
    • bodyContains

      public EmailQuery.Builder bodyContains(String body)
      Filter by body containing text 按正文包含文本过滤
      Parameters:
      body - the text to search in body | 要在正文中搜索的文本
      Returns:
      this builder | 构建器
    • unreadOnly

      public EmailQuery.Builder unreadOnly()
      Filter to only unread emails 仅过滤未读邮件
      Returns:
      this builder | 构建器
    • unreadOnly

      public EmailQuery.Builder unreadOnly(boolean unreadOnly)
      Set unread filter 设置未读过滤
      Parameters:
      unreadOnly - true for unread only | true仅未读
      Returns:
      this builder | 构建器
    • flaggedOnly

      public EmailQuery.Builder flaggedOnly()
      Filter to only flagged/starred emails 仅过滤标记/星标邮件
      Returns:
      this builder | 构建器
    • flaggedOnly

      public EmailQuery.Builder flaggedOnly(boolean flaggedOnly)
      Set flagged filter 设置标记过滤
      Parameters:
      flaggedOnly - true for flagged only | true仅标记
      Returns:
      this builder | 构建器
    • hasAttachments

      public EmailQuery.Builder hasAttachments()
      Filter to only emails with attachments 仅过滤有附件的邮件
      Returns:
      this builder | 构建器
    • hasAttachments

      public EmailQuery.Builder hasAttachments(boolean hasAttachments)
      Set attachment filter 设置附件过滤
      Parameters:
      hasAttachments - true for emails with attachments | true有附件
      Returns:
      this builder | 构建器
    • includeDeleted

      public EmailQuery.Builder includeDeleted()
      Include deleted emails 包含已删除邮件
      Returns:
      this builder | 构建器
    • includeDeleted

      public EmailQuery.Builder includeDeleted(boolean includeDeleted)
      Set include deleted filter 设置包含已删除过滤
      Parameters:
      includeDeleted - true to include deleted | true包含已删除
      Returns:
      this builder | 构建器
    • limit

      public EmailQuery.Builder limit(int limit)
      Set maximum number of emails to return 设置返回的最大邮件数
      Parameters:
      limit - the maximum count | 最大数量
      Returns:
      this builder | 构建器
    • offset

      public EmailQuery.Builder offset(int offset)
      Set offset for pagination 设置分页偏移量
      Parameters:
      offset - the offset | 偏移量
      Returns:
      this builder | 构建器
    • page

      public EmailQuery.Builder page(int limit, int offset)
      Set pagination 设置分页
      Parameters:
      limit - the maximum count | 最大数量
      offset - the offset | 偏移量
      Returns:
      this builder | 构建器
    • sortBy

      public EmailQuery.Builder sortBy(EmailQuery.SortOrder sortOrder)
      Set sort order 设置排序顺序
      Parameters:
      sortOrder - the sort order | 排序顺序
      Returns:
      this builder | 构建器
    • newestFirst

      public EmailQuery.Builder newestFirst()
      Sort by newest first 按最新优先排序
      Returns:
      this builder | 构建器
    • oldestFirst

      public EmailQuery.Builder oldestFirst()
      Sort by oldest first 按最旧优先排序
      Returns:
      this builder | 构建器
    • build

      public EmailQuery build()
      Build the query 构建查询
      Returns:
      the query | 查询