Package com.contentstack.sdk

Class Entry

java.lang.Object

com.contentstack.sdk.Entry

public class Entry
extends Object

The Get a single Entry request fetches a particular entry of a content type.

Since:

01-11-2017

Version:

1.0.0

Author:

Shailesh Mishra

Method Summary

Modifier and Type	Method	Description
Entry	addParam(String key, String value)	This method adds key and value to an Entry.
Entry	configure(org.json.JSONObject jsonObject)
Entry	except(String[] fieldUid)	Specifies list of field ids that would be 'excluded' from the response.
Entry	exceptWithReferenceUid(List<String> fieldUid, String referenceFieldUid)	Specifies an array of 'except' keys that would be 'excluded' in the response.
void	fetch(EntryResultCallBack callback)	Fetches the latest version of the entries from Contentstack.com content stack
Object	get(String key)	Get object value for key.
List<Entry>	getAllEntries(String refKey, String refContentType)	Get value for the given reference key.
Asset	getAsset(String key)	Get an asset from the entry
List<Asset>	getAssets(String key)	Get an assets from the entry.
Boolean	getBoolean(String key)	Get boolean value for key.
String	getContentType()	Get contentType name.
Calendar	getCreateAt()	Get Calendar value of creation time of entry.
String	getCreatedBy()	Get uid who created this entry.
Calendar	getDate(String key)	Get Calendar value for key
Calendar	getDeleteAt()	Get Calendar value of deletion time of entry.
String	getDeletedBy()	Get uid who deleted this entry.
double	getDouble(String key)	Get double value for key
float	getFloat(String key)	Get integer value for key
Group	getGroup(String key)
List<Group>	getGroups(String key)	Get a list of group from entry.
LinkedHashMap<String,Object>	getHeaders()
int	getInt(String key)	Get integer value for key
org.json.JSONArray	getJSONArray(String key)	Get JSONArray value for key
org.json.JSONObject	getJSONObject(String key)	Get JSONObject value for key
String	getLocale()
long	getLong(String key)	Get long value for key
Number	getNumber(String key)	Get JSONObject value for key
short	getShort(String key)	Get short value for key
String	getString(String key)	Get string value for key.
String[]	getTags()	Get tags.
String	getTitle()	Get title string
String	getUid()	Get uid.
Calendar	getUpdateAt()	Get Calendar value of updating time of entry.
String	getUpdatedBy()	Get uid who updated this entry.
String	getURL()	Get url string
Entry	includeBranch()	Includes Branch in the entry response
Entry	includeContentType()	Include Content Type of all returned objects along with objects themselves.
Entry	includeEmbeddedItems()	includeEmbeddedItems instance of Entry Include Embedded Objects (Entries and Assets) along with entry/entries details.
Entry	includeFallback()	Retrieve the published content of the fallback locale if an entry is not localized in specified locale
Entry	includeMetadata()	Includes Metadata the entry response
Entry	includeReference(String referenceField)	Add a constraint that requires a particular reference key details.
Entry	includeReference(String[] referenceFields)	Add a constraint that requires a particular reference key details.
Entry	includeReferenceContentTypeUID()	This method also includes the content type UIDs of the referenced entries returned in the response
Entry	only(String[] fieldUid)	Specifies an array of 'only' keys in BASE object that would be 'included' in the response.
Entry	onlyWithReferenceUid(List<String> fieldUid, String referenceFieldUid)	Specifies an array of 'only' keys that would be 'included' in the response.
void	removeHeader(String key)	Remove header key.
void	setHeader(String key, String value)	Set headers.
Entry	setLocale(String locale)
org.json.JSONObject	toJSON()	Get entry representation in json
Entry	variants(String variants)
Entry	variants(String[] variants)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

configure

public Entry configure(org.json.JSONObject jsonObject)

setHeader

public void setHeader(String key,
                      String value)

Set headers.

Parameters:

key - custom_header_key

value - custom_header_value

Example :

removeHeader

public void removeHeader(String key)

Remove header key.

Parameters:

key - custom_header_key

Example :

            Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
            Entry entry = stack.contentType("form_name").entry("entry_uid");
            entry.removeHeader("custom_header_key");
            

getTitle

public String getTitle()

Get title string

Returns:

String @title

Example :

         String title = entry.getTitle();
         

getURL

public String getURL()

Get url string

Returns:

String @url

Example :

         String url = entry.getURL();
         

getTags

public String[] getTags()

Get tags.

Returns:

String @tags

Example :

         String[] tags = entry.getURL();
         

getContentType

public String getContentType()

Get contentType name.

Returns:

String @contentTypeName

Example :

         String contentType = entry.getFileType();
         

getUid

public String getUid()

Get uid.

Returns:

String @uid

Example :

         String uid = entry.getUid();
         

getLocale

public String getLocale()

setLocale

public Entry setLocale(@NotNull
                       String locale)

Parameters:

locale - String

Returns:

Entry

Example :

         Entry entry = entry.setLanguage();
         

toJSON

public org.json.JSONObject toJSON()

Get entry representation in json

Returns:

resultJson

Example :

         JSONObject json = entry.toJSON();
         

get

public Object get(@NotNull
                  String key)

Get object value for key.

Parameters:

key - field_uid as key.

Example :

            Object obj = entry.get("key");
            

Returns:

Object @resultJson

getString

public String getString(@NotNull
                        String key)

Get string value for key.

Parameters:

key - field_uid as key.

Example :

            String value = entry.getString("key");
            

Returns:

String @getString

getBoolean

public Boolean getBoolean(@NotNull
                          String key)

Get boolean value for key.

Parameters:

key - field_uid as key.

Example :

            Boolean value = entry.getBoolean("key");
            

Returns:

boolean @getBoolean

getJSONArray

public org.json.JSONArray getJSONArray(@NotNull
                                       String key)

Get JSONArray value for key

Parameters:

key - field_uid as key.

Example :

            JSONArray value = entry.getJSONArray("key");
            

Returns:

JSONArray @getJSONArray

getJSONObject

public org.json.JSONObject getJSONObject(@NotNull
                                         String key)

Get JSONObject value for key

Parameters:

key - field_uid as key.

Example :

            JSONObject value = entry.getJSONObject("key");
            

Returns:

JSONObject @getJSONObject

getNumber

public Number getNumber(@NotNull
                        String key)

Get JSONObject value for key

Parameters:

key - field_uid as key.

Example :

            JSONObject value = entry.getJSONObject("key");
            

Returns:

Number @getNumber

getInt

public int getInt(@NotNull
                  String key)

Get integer value for key

Parameters:

key - field_uid as key.

Example :

            int value = entry.getInt("key");
            

Returns:

int @getInt

getFloat

public float getFloat(@NotNull
                      String key)

Get integer value for key

Parameters:

key - field_uid as key.

Returns:

float @getFloat

Example :

         float value = entry.getFloat("key");
         

getDouble

public double getDouble(@NotNull
                        String key)

Get double value for key

Parameters:

key - field_uid as key.

Returns:

double @getDouble

Example :

         double value = entry.getDouble("key");
         

getLong

public long getLong(@NotNull
                    String key)

Get long value for key

Parameters:

key - field_uid as key.

Example :

            long value = entry.getLong("key");
            

Returns:

long @getLong

getShort

public short getShort(@NotNull
                      String key)

Get short value for key

Parameters:

key - field_uid as key.

Example :

            short value = entry.getShort("key");
            

Returns:

short @getShort

getDate

public Calendar getDate(@NotNull
                        String key)

Get Calendar value for key

Parameters:

key - field_uid as key.

Example :

            Calendar value = entry.getDate("key");
            

Returns:

Calendar @getDate

getCreateAt

public Calendar getCreateAt()

Get Calendar value of creation time of entry.

Returns:

Calendar @getCreateAt

Example :

         Calendar createdAt = entry.getCreateAt("key");
         

getCreatedBy

public String getCreatedBy()

Get uid who created this entry.

Returns:

String @getCreatedBy

Example :

         String createdBy_uid = entry.getCreatedBy();
         

getUpdateAt

public Calendar getUpdateAt()

Get Calendar value of updating time of entry.

Returns:

Calendar @getUpdateAt

Example :

         Calendar updatedAt = entry.getUpdateAt("key");
         

getUpdatedBy

public String getUpdatedBy()

Get uid who updated this entry.

Returns:

String @getString

Example :

         String updatedBy_uid = entry.getUpdatedBy();
         

getDeleteAt

public Calendar getDeleteAt()

Get Calendar value of deletion time of entry.

Returns:

Calendar

Example :

         Calendar updatedAt = entry.getUpdateAt("key");
         

getDeletedBy

public String getDeletedBy()

Get uid who deleted this entry.

Returns:

String

Example :

         String deletedBy_uid = entry.getDeletedBy();
         

getAsset

public Asset getAsset(String key)

Get an asset from the entry

Parameters:

key - field_uid as key.

Returns:

Asset

Example :

         Asset asset = entry.getAsset("key");
         

getAssets

public List<Asset> getAssets(String key)

Get an assets from the entry. This works with multiple true fields

Example :

 {
     @code
     List asset = entry.getAssets("key");
 }
 

Parameters:

key - This is the String key

Returns:

ArrayList This returns list of Assets.

getGroup

public Group getGroup(String key)

Parameters:

key - field_uid as key.

Example :

                                                                                                                                                                                                                                                                     Group innerGroup = entry.getGroup("key");
                                                                                                                                                                                                                                                                     return null
            

Returns:

Group

getGroups

public List<Group> getGroups(String key)

Get a list of group from entry.

Note :- This will work when group is multiple true.

Parameters:

key - field_uid as key.

Returns:

list of group from entry

Example :

         Group innerGroup = entry.getGroups("key");
         

getAllEntries

public List<Entry> getAllEntries(String refKey,
                                 String refContentType)

Get value for the given reference key.

Parameters:

refKey - key of a reference field.

refContentType - class uid.

Returns:

ArrayList of Entry instances. Also specified contentType value will be set as class uid for all Entry instance.

Example :

          
          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Query csQuery = stack.contentType("contentType_name").query();
          csQuery.includeReference("for_bug");
          csQuery.find(new QueryResultsCallBack() {<br>
          &#64;Override
          public void onCompletion(ResponseType responseType, QueryResult queryResult, Error error) {<br>
              if(error == null){
                  List&#60;Entry&#62; list = queryResult.getResultObjects();
                   for (int i = 0; i < list.queueSize(); i++) {
                         Entry   entry   = list.get(i);
                         Entry taskEntry = entry.getAllEntries("for_task", "task");
                  }
              }
          }
      });
      

         

except

public Entry except(@NotNull
                    String[] fieldUid)

Specifies list of field ids that would be 'excluded' from the response.

Parameters:

fieldUid - field uid which get 'excluded' from the response.

includeReference

public Entry includeReference(@NotNull
                              String referenceField)

Add a constraint that requires a particular reference key details.

Parameters:

referenceField - key that to be constrained.

includeReference

public Entry includeReference(@NotNull
                              String[] referenceFields)

Add a constraint that requires a particular reference key details.

Parameters:

referenceFields - array key that to be constrained.

only

public Entry only(String[] fieldUid)

Specifies an array of 'only' keys in BASE object that would be 'included' in the response.

Parameters:

fieldUid - Array of the 'only' reference keys to be included in response.

Returns:

Entry object, so you can chain this call.

Example :

          Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
          Entry entry = stack.contentType("form_name").entry("entry_uid");

          entry.only(new String[]{"name", "description"});
         

onlyWithReferenceUid

public Entry onlyWithReferenceUid(@NotNull
                                  List<String> fieldUid,
                                  @NotNull
                                  String referenceFieldUid)

Specifies an array of 'only' keys that would be 'included' in the response.

Parameters:

fieldUid - Array of the 'only' reference keys to be included in response.

referenceFieldUid - Key who has reference to some other class object.

exceptWithReferenceUid

public Entry exceptWithReferenceUid(@NotNull
                                    List<String> fieldUid,
                                    @NotNull
                                    String referenceFieldUid)

Specifies an array of 'except' keys that would be 'excluded' in the response.

Parameters:

fieldUid - Array of the 'except' reference keys to be excluded in response.

referenceFieldUid - Key who has reference to some other class object.

fetch

public void fetch(EntryResultCallBack callback)

Fetches the latest version of the entries from Contentstack.com content stack

Parameters:

callback - EntryResultCallBack object to notify the application when the request has completed.

Example :

                        
                       Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
                       Entry entry = stack.contentType("form_name").entry("entry_uid");<br>
                       entry.fetch(new EntryResultCallBack() {<br>
                       &#64;Override
                        public void onCompletion(ResponseType responseType, Error error) {
                          }<br>
                        });<br>
                        
                        

addParam

public Entry addParam(@NotNull
                      String key,
                      @NotNull
                      String value)

This method adds key and value to an Entry.

Parameters:

key - The key as string which needs to be added to an Entry

value - The value as string which needs to be added to an Entry

Returns:

Entry

Example :

         
         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid"); <br>
         entry.addParam("include_dimensions", "true"); <br>
         entry.fetch(new ResultCallBack() {
         <br>&#64; Override
          public void onCompletion(ResponseType responseType, Error error) {
          }<br>
          });<br>
          
         

includeReferenceContentTypeUID

public Entry includeReferenceContentTypeUID()

This method also includes the content type UIDs of the referenced entries returned in the response

includeContentType

public Entry includeContentType()

Include Content Type of all returned objects along with objects themselves.

includeFallback

public Entry includeFallback()

Retrieve the published content of the fallback locale if an entry is not localized in specified locale

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeFallback();
         

includeEmbeddedItems

public Entry includeEmbeddedItems()

includeEmbeddedItems instance of Entry Include Embedded Objects (Entries and Assets) along with entry/entries details.

includeBranch

public Entry includeBranch()

Includes Branch in the entry response

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeBranch();
         

includeMetadata

public Entry includeMetadata()

Includes Metadata the entry response

Returns:

Entry object, so you can chain this call.

Example :

         Stack stack = Contentstack.stack("apiKey", "deliveryToken", "environment");
         final Entry entry = stack.contentType("user").entry("entryUid");
         entry.includeMetadata();
         

variants

public Entry variants(@NotNull
                      String variants)

variants

public Entry variants(@NotNull
                      String[] variants)

getHeaders

public LinkedHashMap<String,Object> getHeaders()