github.com/minio/minio@v0.0.0-20240328213742-3f72439b8a27/internal/bucket/replication/tag.go (about)

     1  // Copyright (c) 2015-2021 MinIO, Inc.
     2  //
     3  // This file is part of MinIO Object Storage stack
     4  //
     5  // This program is free software: you can redistribute it and/or modify
     6  // it under the terms of the GNU Affero General Public License as published by
     7  // the Free Software Foundation, either version 3 of the License, or
     8  // (at your option) any later version.
     9  //
    10  // This program is distributed in the hope that it will be useful
    11  // but WITHOUT ANY WARRANTY; without even the implied warranty of
    12  // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    13  // GNU Affero General Public License for more details.
    14  //
    15  // You should have received a copy of the GNU Affero General Public License
    16  // along with this program.  If not, see <http://www.gnu.org/licenses/>.
    17  
    18  package replication
    19  
    20  import (
    21  	"encoding/xml"
    22  	"unicode/utf8"
    23  )
    24  
    25  // Tag - a tag for a replication configuration Rule filter.
    26  type Tag struct {
    27  	XMLName xml.Name `xml:"Tag" json:"Tag"`
    28  	Key     string   `xml:"Key,omitempty" json:"Key,omitempty"`
    29  	Value   string   `xml:"Value,omitempty" json:"Value,omitempty"`
    30  }
    31  
    32  var (
    33  	errInvalidTagKey   = Errorf("The TagKey you have provided is invalid")
    34  	errInvalidTagValue = Errorf("The TagValue you have provided is invalid")
    35  )
    36  
    37  func (tag Tag) String() string {
    38  	return tag.Key + "=" + tag.Value
    39  }
    40  
    41  // IsEmpty returns whether this tag is empty or not.
    42  func (tag Tag) IsEmpty() bool {
    43  	return tag.Key == ""
    44  }
    45  
    46  // Validate checks this tag.
    47  func (tag Tag) Validate() error {
    48  	if len(tag.Key) == 0 || utf8.RuneCountInString(tag.Key) > 128 {
    49  		return errInvalidTagKey
    50  	}
    51  
    52  	if utf8.RuneCountInString(tag.Value) > 256 {
    53  		return errInvalidTagValue
    54  	}
    55  
    56  	return nil
    57  }