高效Java第十條始終要覆蓋toString

java.lang.Object默認(rèn)實(shí)現(xiàn)的toString方法返回類名@散列碼的無符號(hào)十六進(jìn)制表示臀规。

toString的通用約定

返回的字符串應(yīng)該是一個(gè)“簡潔的拓哺,但信息豐富的介袜,并且易于閱讀的表達(dá)形式”偎漫。
建議所有的子類都覆蓋這個(gè)方法再登。

遵守toString的通用約定的意義

雖然遵守toString的約定并不像遵守equalshashCode的約定那么重要溅固,但是付秕,提供好的toString實(shí)現(xiàn)可以使類用起來更加舒適。
使用println侍郭、printf询吴、字符串聯(lián)操作符(+)、assert亮元、調(diào)試器打印對(duì)象的時(shí)候猛计,toString方法會(huì)被自動(dòng)調(diào)用。
下面是程序員經(jīng)常使用的調(diào)試方式:


提供好的toString方法爆捞,不僅有益于這個(gè)類的實(shí)例奉瘤,同樣也有益于那些包含這些實(shí)例的引用的對(duì)象,特別是集合對(duì)象煮甥。

在實(shí)際應(yīng)用中盗温,toString方法應(yīng)該返回對(duì)象所有值得關(guān)注的信息藕赞。
如果對(duì)象太大,或者對(duì)象中包含的狀態(tài)信息難以用字符串來表達(dá)卖局,這個(gè)時(shí)候找默,toString應(yīng)該返回一個(gè)摘要信息。
理想情況下吼驶,字符串應(yīng)該是自描述的。

在文檔中指定返回值的格式

對(duì)于值類也建議這么做店煞。
指定格式的好處是蟹演,它可以被用做一種標(biāo)準(zhǔn)的、明確的顷蟀、適合人閱讀的對(duì)象表示法酒请。
這種表示法可以用于輸入和輸出,以及用在永久的適合于人類閱讀的數(shù)據(jù)對(duì)象中鸣个,例如XML文檔羞反。
如果指定了格式,最好再提供一個(gè)相匹配的靜態(tài)工廠或者構(gòu)造器囤萤,以便程序員可以很容易地在對(duì)象和它的字符串表示法之間來回轉(zhuǎn)換昼窗,如BigIntegerBigDecimal和絕大多數(shù)的基本類型包裝類(值類)涛舍。

在文檔中指定返回值的格式的不足

如果這個(gè)類已經(jīng)被廣泛使用澄惊,一旦指定格式,就必須始終如一地堅(jiān)持這種格式富雅。
如果不指定格式掸驱,就可以保留靈活性,以便于在將來的發(fā)行版本中增加信息没佑,或者改進(jìn)格式毕贼。

無論你是否決定指定格式,都應(yīng)該在文檔中明確地表示你的意圖蛤奢。

在文檔中指定返回值的格式的例子

不在文檔中指定返回值的格式的例子

都為toString返回值中包含的所有信息鬼癣,提供一種編程式的訪問途徑

如果不這么做,就會(huì)迫使那些需要這些信息的程序員不得不自己去解析這些字符串啤贩。
除了降低了程序的性能扣溺,使得程序員們不得不做這些不必要的工作之外,這個(gè)解析過程也很容易出錯(cuò)瓜晤,會(huì)導(dǎo)致系統(tǒng)不穩(wěn)定锥余,如果格式發(fā)生變化,還會(huì)使系統(tǒng)崩潰痢掠。如果沒有提供這些訪問驱犹,即使你已經(jīng)指明了字符串的格式是可以變化的嘲恍,這個(gè)字符串格式也成為事實(shí)上的API。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末雄驹,一起剝皮案震驚了整個(gè)濱河市佃牛,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌医舆,老刑警劉巖俘侠,帶你破解...
    沈念sama閱讀 222,627評(píng)論 6 517
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異蔬将,居然都是意外死亡爷速,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,180評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門霞怀,熙熙樓的掌柜王于貴愁眉苦臉地迎上來惫东,“玉大人,你說我怎么就攤上這事毙石×冢” “怎么了?”我有些...
    開封第一講書人閱讀 169,346評(píng)論 0 362
  • 文/不壞的土叔 我叫張陵徐矩,是天一觀的道長滞时。 經(jīng)常有香客問我,道長滤灯,這世上最難降的妖魔是什么漂洋? 我笑而不...
    開封第一講書人閱讀 60,097評(píng)論 1 300
  • 正文 為了忘掉前任,我火速辦了婚禮力喷,結(jié)果婚禮上刽漂,老公的妹妹穿的比我還像新娘。我一直安慰自己弟孟,他們只是感情好贝咙,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,100評(píng)論 6 398
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著拂募,像睡著了一般庭猩。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上陈症,一...
    開封第一講書人閱讀 52,696評(píng)論 1 312
  • 那天蔼水,我揣著相機(jī)與錄音,去河邊找鬼录肯。 笑死趴腋,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播优炬,決...
    沈念sama閱讀 41,165評(píng)論 3 422
  • 文/蒼蘭香墨 我猛地睜開眼颁井,長吁一口氣:“原來是場噩夢(mèng)啊……” “哼!你這毒婦竟也來了蠢护?” 一聲冷哼從身側(cè)響起雅宾,我...
    開封第一講書人閱讀 40,108評(píng)論 0 277
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎葵硕,沒想到半個(gè)月后眉抬,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 46,646評(píng)論 1 319
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡懈凹,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,709評(píng)論 3 342
  • 正文 我和宋清朗相戀三年蜀变,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片蘸劈。...
    茶點(diǎn)故事閱讀 40,861評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖尊沸,靈堂內(nèi)的尸體忽然破棺而出威沫,到底是詐尸還是另有隱情,我是刑警寧澤洼专,帶...
    沈念sama閱讀 36,527評(píng)論 5 351
  • 正文 年R本政府宣布棒掠,位于F島的核電站,受9級(jí)特大地震影響屁商,放射性物質(zhì)發(fā)生泄漏烟很。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,196評(píng)論 3 336
  • 文/蒙蒙 一蜡镶、第九天 我趴在偏房一處隱蔽的房頂上張望雾袱。 院中可真熱鬧,春花似錦官还、人聲如沸芹橡。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,698評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽林说。三九已至,卻和暖如春屯伞,著一層夾襖步出監(jiān)牢的瞬間腿箩,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,804評(píng)論 1 274
  • 我被黑心中介騙來泰國打工劣摇, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留珠移,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 49,287評(píng)論 3 379
  • 正文 我出身青樓,卻偏偏與公主長得像剑梳,于是被迫代替她去往敵國和親唆貌。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,860評(píng)論 2 361

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理垢乙,服務(wù)發(fā)現(xiàn)锨咙,斷路器,智...
    卡卡羅2017閱讀 134,716評(píng)論 18 139
  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法追逮,類相關(guān)的語法酪刀,內(nèi)部類的語法,繼承相關(guān)的語法钮孵,異常的語法骂倘,線程的語...
    子非魚_t_閱讀 31,665評(píng)論 18 399
  • 第5章 引用類型(返回首頁) 本章內(nèi)容 使用對(duì)象 創(chuàng)建并操作數(shù)組 理解基本的JavaScript類型 使用基本類型...
    大學(xué)一百閱讀 3,238評(píng)論 0 4
  • 淺黑色的厚云織成一張巨網(wǎng)籠罩著這個(gè)小小的海島漸瀝的中雨已經(jīng)持續(xù)了兩天兩夜居住在島上的小動(dòng)物們都宅在家中空氣中都彌漫...
    林嶼nono閱讀 572評(píng)論 2 8