public static final class FeedPack.Builder extends GeneratedMessage.Builder<FeedPack.Builder> implements FeedPackOrBuilderFeedPack is a logical container for related LogTypes for which feeds can be configured.
Protobuf type google.cloud.chronicle.v1.FeedPack
Inheritance
java.lang.Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessage.Builder > FeedPack.BuilderImplements
FeedPackOrBuilderStatic Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
Methods
addAllCategories(Iterable<String> values)
public FeedPack.Builder addAllCategories(Iterable<String> values)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<String>The categories to add. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
addAllPackLogTypes(Iterable<? extends PackLogType> values)
public FeedPack.Builder addAllPackLogTypes(Iterable<? extends PackLogType> values)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
values |
Iterable<? extends com.google.cloud.chronicle.v1.PackLogType> |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
addCategories(String value)
public FeedPack.Builder addCategories(String value)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe categories to add. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
addCategoriesBytes(ByteString value)
public FeedPack.Builder addCategoriesBytes(ByteString value)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes of the categories to add. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
addPackLogTypes(PackLogType value)
public FeedPack.Builder addPackLogTypes(PackLogType value)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
PackLogType |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
addPackLogTypes(PackLogType.Builder builderForValue)
public FeedPack.Builder addPackLogTypes(PackLogType.Builder builderForValue)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
builderForValue |
PackLogType.Builder |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
addPackLogTypes(int index, PackLogType value)
public FeedPack.Builder addPackLogTypes(int index, PackLogType value)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
PackLogType |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
addPackLogTypes(int index, PackLogType.Builder builderForValue)
public FeedPack.Builder addPackLogTypes(int index, PackLogType.Builder builderForValue)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
PackLogType.Builder |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
addPackLogTypesBuilder()
public PackLogType.Builder addPackLogTypesBuilder()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
PackLogType.Builder |
|
addPackLogTypesBuilder(int index)
public PackLogType.Builder addPackLogTypesBuilder(int index)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
PackLogType.Builder |
|
build()
public FeedPack build()| Returns | |
|---|---|
| Type | Description |
FeedPack |
|
buildPartial()
public FeedPack buildPartial()| Returns | |
|---|---|
| Type | Description |
FeedPack |
|
clear()
public FeedPack.Builder clear()| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
clearCategories()
public FeedPack.Builder clearCategories()Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearDescription()
public FeedPack.Builder clearDescription()Output only. The description of the feed pack.
string description = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearDisplayName()
public FeedPack.Builder clearDisplayName()Output only. The display name of the feed pack.
string display_name = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearHidden()
public FeedPack.Builder clearHidden()Output only. Whether the feed pack should be displayed in the Feeds Page.
bool hidden = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearIcon()
public FeedPack.Builder clearIcon()Output only. The icon image of the content pack in base64 in png format.
bytes icon = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearName()
public FeedPack.Builder clearName()Identifier. The resource name of the feed pack. Format: projects/{project}/locations/{location}/instances/{instance}/feedPacks/{feed_pack}
string name = 1 [(.google.api.field_behavior) = IDENTIFIER];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearPackDocumentation()
public FeedPack.Builder clearPackDocumentation()Output only. Pack specific documentation in markdown format.
string pack_documentation = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
clearPackLogTypes()
public FeedPack.Builder clearPackLogTypes()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
clearPackType()
public FeedPack.Builder clearPackType()Output only. Type of pack.
.google.cloud.chronicle.v1.FeedPack.PackType pack_type = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
getCategories(int index)
public String getCategories(int index)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the element to return. |
| Returns | |
|---|---|
| Type | Description |
String |
The categories at the given index. |
getCategoriesBytes(int index)
public ByteString getCategoriesBytes(int index)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
intThe index of the value to return. |
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes of the categories at the given index. |
getCategoriesCount()
public int getCategoriesCount()Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
int |
The count of categories. |
getCategoriesList()
public ProtocolStringList getCategoriesList()Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
ProtocolStringList |
A list containing the categories. |
getDefaultInstanceForType()
public FeedPack getDefaultInstanceForType()| Returns | |
|---|---|
| Type | Description |
FeedPack |
|
getDescription()
public String getDescription()Output only. The description of the feed pack.
string description = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
String |
The description. |
getDescriptionBytes()
public ByteString getDescriptionBytes()Output only. The description of the feed pack.
string description = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for description. |
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()| Returns | |
|---|---|
| Type | Description |
Descriptor |
|
getDisplayName()
public String getDisplayName()Output only. The display name of the feed pack.
string display_name = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
String |
The displayName. |
getDisplayNameBytes()
public ByteString getDisplayNameBytes()Output only. The display name of the feed pack.
string display_name = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for displayName. |
getHidden()
public boolean getHidden()Output only. Whether the feed pack should be displayed in the Feeds Page.
bool hidden = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
boolean |
The hidden. |
getIcon()
public ByteString getIcon()Output only. The icon image of the content pack in base64 in png format.
bytes icon = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The icon. |
getName()
public String getName()Identifier. The resource name of the feed pack. Format: projects/{project}/locations/{location}/instances/{instance}/feedPacks/{feed_pack}
string name = 1 [(.google.api.field_behavior) = IDENTIFIER];
| Returns | |
|---|---|
| Type | Description |
String |
The name. |
getNameBytes()
public ByteString getNameBytes()Identifier. The resource name of the feed pack. Format: projects/{project}/locations/{location}/instances/{instance}/feedPacks/{feed_pack}
string name = 1 [(.google.api.field_behavior) = IDENTIFIER];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for name. |
getPackDocumentation()
public String getPackDocumentation()Output only. Pack specific documentation in markdown format.
string pack_documentation = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
String |
The packDocumentation. |
getPackDocumentationBytes()
public ByteString getPackDocumentationBytes()Output only. Pack specific documentation in markdown format.
string pack_documentation = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
ByteString |
The bytes for packDocumentation. |
getPackLogTypes(int index)
public PackLogType getPackLogTypes(int index)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
PackLogType |
|
getPackLogTypesBuilder(int index)
public PackLogType.Builder getPackLogTypesBuilder(int index)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
PackLogType.Builder |
|
getPackLogTypesBuilderList()
public List<PackLogType.Builder> getPackLogTypesBuilderList()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
List<Builder> |
|
getPackLogTypesCount()
public int getPackLogTypesCount()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
int |
|
getPackLogTypesList()
public List<PackLogType> getPackLogTypesList()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
List<PackLogType> |
|
getPackLogTypesOrBuilder(int index)
public PackLogTypeOrBuilder getPackLogTypesOrBuilder(int index)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
PackLogTypeOrBuilder |
|
getPackLogTypesOrBuilderList()
public List<? extends PackLogTypeOrBuilder> getPackLogTypesOrBuilderList()Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
List<? extends com.google.cloud.chronicle.v1.PackLogTypeOrBuilder> |
|
getPackType()
public FeedPack.PackType getPackType()Output only. Type of pack.
.google.cloud.chronicle.v1.FeedPack.PackType pack_type = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
FeedPack.PackType |
The packType. |
getPackTypeValue()
public int getPackTypeValue()Output only. Type of pack.
.google.cloud.chronicle.v1.FeedPack.PackType pack_type = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Returns | |
|---|---|
| Type | Description |
int |
The enum numeric value on the wire for packType. |
internalGetFieldAccessorTable()
protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()| Returns | |
|---|---|
| Type | Description |
FieldAccessorTable |
|
isInitialized()
public final boolean isInitialized()| Returns | |
|---|---|
| Type | Description |
boolean |
|
mergeFrom(FeedPack other)
public FeedPack.Builder mergeFrom(FeedPack other)| Parameter | |
|---|---|
| Name | Description |
other |
FeedPack |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public FeedPack.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)| Parameters | |
|---|---|
| Name | Description |
input |
CodedInputStream |
extensionRegistry |
ExtensionRegistryLite |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
| Exceptions | |
|---|---|
| Type | Description |
IOException |
|
mergeFrom(Message other)
public FeedPack.Builder mergeFrom(Message other)| Parameter | |
|---|---|
| Name | Description |
other |
Message |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
removePackLogTypes(int index)
public FeedPack.Builder removePackLogTypes(int index)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
index |
int |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
setCategories(int index, String value)
public FeedPack.Builder setCategories(int index, String value)Output only. Categories the featured content is associated with. In case of product feed packs, there will be only one category.
repeated string categories = 5 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameters | |
|---|---|
| Name | Description |
index |
intThe index to set the value at. |
value |
StringThe categories to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setDescription(String value)
public FeedPack.Builder setDescription(String value)Output only. The description of the feed pack.
string description = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe description to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setDescriptionBytes(ByteString value)
public FeedPack.Builder setDescriptionBytes(ByteString value)Output only. The description of the feed pack.
string description = 3 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for description to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setDisplayName(String value)
public FeedPack.Builder setDisplayName(String value)Output only. The display name of the feed pack.
string display_name = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe displayName to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setDisplayNameBytes(ByteString value)
public FeedPack.Builder setDisplayNameBytes(ByteString value)Output only. The display name of the feed pack.
string display_name = 2 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for displayName to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setHidden(boolean value)
public FeedPack.Builder setHidden(boolean value)Output only. Whether the feed pack should be displayed in the Feeds Page.
bool hidden = 8 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
booleanThe hidden to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setIcon(ByteString value)
public FeedPack.Builder setIcon(ByteString value)Output only. The icon image of the content pack in base64 in png format.
bytes icon = 4 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe icon to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setName(String value)
public FeedPack.Builder setName(String value)Identifier. The resource name of the feed pack. Format: projects/{project}/locations/{location}/instances/{instance}/feedPacks/{feed_pack}
string name = 1 [(.google.api.field_behavior) = IDENTIFIER];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe name to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setNameBytes(ByteString value)
public FeedPack.Builder setNameBytes(ByteString value)Identifier. The resource name of the feed pack. Format: projects/{project}/locations/{location}/instances/{instance}/feedPacks/{feed_pack}
string name = 1 [(.google.api.field_behavior) = IDENTIFIER];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for name to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setPackDocumentation(String value)
public FeedPack.Builder setPackDocumentation(String value)Output only. Pack specific documentation in markdown format.
string pack_documentation = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
StringThe packDocumentation to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setPackDocumentationBytes(ByteString value)
public FeedPack.Builder setPackDocumentationBytes(ByteString value)Output only. Pack specific documentation in markdown format.
string pack_documentation = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
ByteStringThe bytes for packDocumentation to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setPackLogTypes(int index, PackLogType value)
public FeedPack.Builder setPackLogTypes(int index, PackLogType value)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameters | |
|---|---|
| Name | Description |
index |
int |
value |
PackLogType |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
setPackLogTypes(int index, PackLogType.Builder builderForValue)
public FeedPack.Builder setPackLogTypes(int index, PackLogType.Builder builderForValue)Output only. Log types featured in the pack.
repeated .google.cloud.chronicle.v1.PackLogType pack_log_types = 7 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameters | |
|---|---|
| Name | Description |
index |
int |
builderForValue |
PackLogType.Builder |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
|
setPackType(FeedPack.PackType value)
public FeedPack.Builder setPackType(FeedPack.PackType value)Output only. Type of pack.
.google.cloud.chronicle.v1.FeedPack.PackType pack_type = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
FeedPack.PackTypeThe packType to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |
setPackTypeValue(int value)
public FeedPack.Builder setPackTypeValue(int value)Output only. Type of pack.
.google.cloud.chronicle.v1.FeedPack.PackType pack_type = 6 [(.google.api.field_behavior) = OUTPUT_ONLY];
| Parameter | |
|---|---|
| Name | Description |
value |
intThe enum numeric value on the wire for packType to set. |
| Returns | |
|---|---|
| Type | Description |
FeedPack.Builder |
This builder for chaining. |