-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathactive_record_validations.html
1164 lines (1036 loc) · 82.3 KB
/
active_record_validations.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>액티브 레코드 유효성 검증 — Ruby on Rails Guides</title>
<link rel="stylesheet" type="text/css" href="stylesheets/style.css" data-turbolinks-track="reload">
<link rel="stylesheet" type="text/css" href="stylesheets/print.css" media="print">
<link rel="stylesheet" type="text/css" href="stylesheets/syntaxhighlighter/shCore.css" data-turbolinks-track="reload">
<link rel="stylesheet" type="text/css" href="stylesheets/syntaxhighlighter/shThemeRailsGuides.css" data-turbolinks-track="reload">
<link rel="stylesheet" type="text/css" href="stylesheets/fixes.css" data-turbolinks-track="reload">
<link href="images/favicon.ico" rel="shortcut icon" type="image/x-icon" />
<script src="javascripts/syntaxhighlighter.js" data-turbolinks-track="reload"></script>
<script src="javascripts/turbolinks.js" data-turbolinks-track="reload"></script>
<script src="javascripts/guides.js" data-turbolinks-track="reload"></script>
<script src="javascripts/responsive-tables.js" data-turbolinks-track="reload"></script>
<meta property="og:title" content="액티브 레코드 유효성 검증 — Ruby on Rails Guides" />
<meta name="description" content="액티브 레코드 유효성 검증본 가이드는 액티브 레코드의 유효성 검사 기능을 사용하여 데이터베이스로 이동하기 전에 객체의 상태를 확인하는 방법을 설명한다.본 가이드를 읽은 후 아래의 내용을 알게 될 것이다. 내장된 액티브 레코드 유효성 검증 헬퍼 메소드를 사용하는 방법. 사용자 자신이 직접 유효성 검증 메소드를 만드는 방법. 유효성 검증 프로세스에서 생성된 에러 메시지를 처리하는 방법." />
<meta property="og:description" content="액티브 레코드 유효성 검증본 가이드는 액티브 레코드의 유효성 검사 기능을 사용하여 데이터베이스로 이동하기 전에 객체의 상태를 확인하는 방법을 설명한다.본 가이드를 읽은 후 아래의 내용을 알게 될 것이다. 내장된 액티브 레코드 유효성 검증 헬퍼 메소드를 사용하는 방법. 사용자 자신이 직접 유효성 검증 메소드를 만드는 방법. 유효성 검증 프로세스에서 생성된 에러 메시지를 처리하는 방법." />
<meta property="og:locale" content="en_US" />
<meta property="og:site_name" content="Ruby on Rails Guides" />
<meta property="og:image" content="https://avatars.githubusercontent.com/u/4223" />
<meta property="og:type" content="website" />
</head>
<body class="guide">
<div id="topNav">
<div class="wrapper">
<strong class="more-info-label">공식 웹사이트 <a href="https://rubyonrails.org/">rubyonrails.org:</a> </strong>
<span class="red-button more-info-button">
루비온레일스 웹사이트
</span>
<ul class="more-info-links s-hidden">
<li class="more-info"><a href="https://weblog.rubyonrails.org/">블로그</a></li>
<li class="more-info"><a href="https://guides.rubyonrails.org/">영문가이드</a></li>
<li class="more-info"><a href="https://api.rubyonrails.org/">레일스API</a></li>
<li class="more-info"><a href="https://stackoverflow.com/questions/tagged/ruby-on-rails">질문하기</a></li>
<li class="more-info"><a href="https://github.com/rails/rails">GitHub에서 기여하기</a></li>
</ul>
</div>
</div>
<div id="header">
<div class="wrapper clearfix">
<h1><a href="index.html" title="Return to home page">Guides.rubyonrails.org</a></h1>
<ul class="nav">
<li><a class="nav-item" href="index.html">홈</a></li>
<li class="guides-index guides-index-large">
<a href="index.html" id="guidesMenu" class="guides-index-item nav-item">가이드 인덱스</a>
<div id="guides" class="clearfix" style="display: none;">
<hr />
<div class="guides-section-container">
<div class="guides-section">
<dt>시작하면서</dt>
<dd><a href="getting_started.html">레일스로 시작하기</a></dd>
</div>
<div class="guides-section">
<dt>모델</dt>
<dd><a href="active_record_basics.html">액티브 레코드 기본</a></dd>
<dd><a href="active_record_migrations.html">액티브 레코드 마이그레이션</a></dd>
<dd><a href="active_record_validations.html">액티브 레코드 유효성 검증</a></dd>
<dd><a href="active_record_callbacks.html">액티브 레코드 콜백</a></dd>
<dd><a href="association_basics.html">Active Record Associations</a></dd>
<dd><a href="active_record_querying.html">Active Record Query Interface</a></dd>
</div>
<div class="guides-section">
<dt>Views</dt>
<dd><a href="layouts_and_rendering.html">Layouts and Rendering in Rails</a></dd>
<dd><a href="form_helpers.html">Action View Form Helpers</a></dd>
</div>
<div class="guides-section">
<dt>Controllers</dt>
<dd><a href="action_controller_overview.html">Action Controller Overview</a></dd>
<dd><a href="routing.html">Rails Routing from the Outside In</a></dd>
</div>
<div class="guides-section">
<dt>Other Components</dt>
<dd><a href="active_support_core_extensions.html">Active Support Core Extensions</a></dd>
<dd><a href="action_mailer_basics.html">Action Mailer Basics</a></dd>
<dd><a href="active_job_basics.html">Active Job Basics</a></dd>
<dd><a href="active_storage_overview.html">Active Storage Overview</a></dd>
<dd><a href="action_cable_overview.html">Action Cable Overview</a></dd>
</div>
<div class="guides-section">
<dt>Digging Deeper</dt>
<dd><a href="i18n.html">Rails Internationalization (I18n) API</a></dd>
<dd><a href="testing.html">Testing Rails Applications</a></dd>
<dd><a href="security.html">Securing Rails Applications</a></dd>
<dd><a href="debugging_rails_applications.html">Debugging Rails Applications</a></dd>
<dd><a href="configuring.html">Configuring Rails Applications</a></dd>
<dd><a href="command_line.html">The Rails Command Line</a></dd>
<dd><a href="asset_pipeline.html">The Asset Pipeline</a></dd>
<dd><a href="working_with_javascript_in_rails.html">Working with JavaScript in Rails</a></dd>
<dd><a href="autoloading_and_reloading_constants.html">Autoloading and Reloading Constants (Zeitwerk Mode)</a></dd>
<dd><a href="autoloading_and_reloading_constants_classic_mode.html">Autoloading and Reloading Constants (Classic Mode)</a></dd>
<dd><a href="caching_with_rails.html">Caching with Rails: An Overview</a></dd>
<dd><a href="api_app.html">Using Rails for API-only Applications</a></dd>
</div>
<div class="guides-section">
<dt>Extending Rails</dt>
<dd><a href="rails_on_rack.html">Rails on Rack</a></dd>
<dd><a href="generators.html">Creating and Customizing Rails Generators & Templates</a></dd>
</div>
<div class="guides-section">
<dt>Contributions</dt>
<dd><a href="contributing_to_ruby_on_rails.html">Contributing to Ruby on Rails</a></dd>
<dd><a href="api_documentation_guidelines.html">API Documentation Guidelines</a></dd>
<dd><a href="ruby_on_rails_guides_guidelines.html">Guides Guidelines</a></dd>
</div>
<div class="guides-section">
<dt>Policies</dt>
<dd><a href="maintenance_policy.html">Maintenance Policy</a></dd>
</div>
<div class="guides-section">
<dt>Release Notes</dt>
<dd><a href="upgrading_ruby_on_rails.html">Upgrading Ruby on Rails</a></dd>
<dd><a href="6_0_release_notes.html">Version 6.0 - August 2019</a></dd>
<dd><a href="5_2_release_notes.html">Version 5.2 - April 2018</a></dd>
<dd><a href="5_1_release_notes.html">Version 5.1 - April 2017</a></dd>
<dd><a href="5_0_release_notes.html">Version 5.0 - June 2016</a></dd>
<dd><a href="4_2_release_notes.html">Version 4.2 - December 2014</a></dd>
<dd><a href="4_1_release_notes.html">Version 4.1 - April 2014</a></dd>
<dd><a href="4_0_release_notes.html">Version 4.0 - June 2013</a></dd>
<dd><a href="3_2_release_notes.html">Version 3.2 - January 2012</a></dd>
<dd><a href="3_1_release_notes.html">Version 3.1 - August 2011</a></dd>
<dd><a href="3_0_release_notes.html">Version 3.0 - August 2010</a></dd>
<dd><a href="2_3_release_notes.html">Version 2.3 - March 2009</a></dd>
<dd><a href="2_2_release_notes.html">Version 2.2 - November 2008</a></dd>
</div>
</div>
</div>
</li>
<li><a class="nav-item" href="contributing_to_ruby_on_rails.html">기여하기</a></li>
<li class="guides-index guides-index-small">
<select class="guides-index-item nav-item">
<option value="index.html">가이드 인덱스</option>
<optgroup label="시작하면서">
<option value="getting_started.html">레일스로 시작하기</option>
</optgroup>
<optgroup label="모델">
<option value="active_record_basics.html">액티브 레코드 기본</option>
<option value="active_record_migrations.html">액티브 레코드 마이그레이션</option>
<option value="active_record_validations.html">액티브 레코드 유효성 검증</option>
<option value="active_record_callbacks.html">액티브 레코드 콜백</option>
<option value="association_basics.html">Active Record Associations</option>
<option value="active_record_querying.html">Active Record Query Interface</option>
</optgroup>
<optgroup label="Views">
<option value="layouts_and_rendering.html">Layouts and Rendering in Rails</option>
<option value="form_helpers.html">Action View Form Helpers</option>
</optgroup>
<optgroup label="Controllers">
<option value="action_controller_overview.html">Action Controller Overview</option>
<option value="routing.html">Rails Routing from the Outside In</option>
</optgroup>
<optgroup label="Other Components">
<option value="active_support_core_extensions.html">Active Support Core Extensions</option>
<option value="action_mailer_basics.html">Action Mailer Basics</option>
<option value="active_job_basics.html">Active Job Basics</option>
<option value="active_storage_overview.html">Active Storage Overview</option>
<option value="action_cable_overview.html">Action Cable Overview</option>
</optgroup>
<optgroup label="Digging Deeper">
<option value="i18n.html">Rails Internationalization (I18n) API</option>
<option value="testing.html">Testing Rails Applications</option>
<option value="security.html">Securing Rails Applications</option>
<option value="debugging_rails_applications.html">Debugging Rails Applications</option>
<option value="configuring.html">Configuring Rails Applications</option>
<option value="command_line.html">The Rails Command Line</option>
<option value="asset_pipeline.html">The Asset Pipeline</option>
<option value="working_with_javascript_in_rails.html">Working with JavaScript in Rails</option>
<option value="autoloading_and_reloading_constants.html">Autoloading and Reloading Constants (Zeitwerk Mode)</option>
<option value="autoloading_and_reloading_constants_classic_mode.html">Autoloading and Reloading Constants (Classic Mode)</option>
<option value="caching_with_rails.html">Caching with Rails: An Overview</option>
<option value="api_app.html">Using Rails for API-only Applications</option>
</optgroup>
<optgroup label="Extending Rails">
<option value="rails_on_rack.html">Rails on Rack</option>
<option value="generators.html">Creating and Customizing Rails Generators & Templates</option>
</optgroup>
<optgroup label="Contributions">
<option value="contributing_to_ruby_on_rails.html">Contributing to Ruby on Rails</option>
<option value="api_documentation_guidelines.html">API Documentation Guidelines</option>
<option value="ruby_on_rails_guides_guidelines.html">Guides Guidelines</option>
</optgroup>
<optgroup label="Policies">
<option value="maintenance_policy.html">Maintenance Policy</option>
</optgroup>
<optgroup label="Release Notes">
<option value="upgrading_ruby_on_rails.html">Upgrading Ruby on Rails</option>
<option value="6_0_release_notes.html">Version 6.0 - August 2019</option>
<option value="5_2_release_notes.html">Version 5.2 - April 2018</option>
<option value="5_1_release_notes.html">Version 5.1 - April 2017</option>
<option value="5_0_release_notes.html">Version 5.0 - June 2016</option>
<option value="4_2_release_notes.html">Version 4.2 - December 2014</option>
<option value="4_1_release_notes.html">Version 4.1 - April 2014</option>
<option value="4_0_release_notes.html">Version 4.0 - June 2013</option>
<option value="3_2_release_notes.html">Version 3.2 - January 2012</option>
<option value="3_1_release_notes.html">Version 3.1 - August 2011</option>
<option value="3_0_release_notes.html">Version 3.0 - August 2010</option>
<option value="2_3_release_notes.html">Version 2.3 - March 2009</option>
<option value="2_2_release_notes.html">Version 2.2 - November 2008</option>
</optgroup>
</select>
</li>
</ul>
</div>
</div>
<hr class="hide" />
<div id="feature">
<div class="wrapper">
<h2 id="active-record-validations">액티브 레코드 유효성 검증</h2><p>본 가이드는 액티브 레코드의 유효성 검사 기능을 사용하여 데이터베이스로 이동하기 전에 객체의 상태를 확인하는 방법을 설명한다.</p><p>본 가이드를 읽은 후 아래의 내용을 알게 될 것이다.</p>
<ul>
<li>내장된 액티브 레코드 유효성 검증 헬퍼 메소드를 사용하는 방법.</li>
<li>사용자 자신이 직접 유효성 검증 메소드를 만드는 방법.</li>
<li>유효성 검증 프로세스에서 생성된 에러 메시지를 처리하는 방법.</li>
</ul>
<div id="subCol">
<h3 class="chapter"><img src="images/chapters_icon.gif" alt="" />Chapters</h3>
<ol class="chapters">
<li>
<a href="#validations-overview">유효성 검증 개요</a>
<ul>
<li><a href="#why-use-validations?">유효성 검증을 사용하는 이유</a></li>
<li><a href="#when-does-validation-happen?">유효성 검증이 발생하는 시점</a></li>
<li><a href="#skipping-validations">유효성 검증 피하기</a></li>
<li><a href="#valid?-and-invalid?"><code>valid?</code>와 <code>invalid?</code> 메소드</a></li>
<li><a href="#validations-overview-errors"><code>errors[]</code></a></li>
<li><a href="#validations-overview-errors-details"><code>errors.details</code></a></li>
</ul>
</li>
<li>
<a href="#validation-helpers">유효성 검증 헬퍼 메소드</a>
<ul>
<li><a href="#acceptance"><code>acceptance</code></a></li>
<li><a href="#validates-associated"><code>validates_associated</code></a></li>
<li><a href="#confirmation"><code>confirmation</code></a></li>
<li><a href="#exclusion"><code>exclusion</code></a></li>
<li><a href="#format"><code>format</code></a></li>
<li><a href="#inclusion"><code>inclusion</code></a></li>
<li><a href="#length"><code>length</code></a></li>
<li><a href="#numericality"><code>numericality</code></a></li>
<li><a href="#presence"><code>presence</code></a></li>
<li><a href="#absence"><code>absence</code></a></li>
<li><a href="#uniqueness"><code>uniqueness</code></a></li>
<li><a href="#validates-with"><code>validates_with</code></a></li>
<li><a href="#validates-each"><code>validates_each</code></a></li>
</ul>
</li>
<li>
<a href="#common-validation-options">일반적인 유효성 검증 옵션</a>
<ul>
<li><a href="#allow-nil"><code>:allow_nil</code></a></li>
<li><a href="#allow-blank"><code>:allow_blank</code></a></li>
<li><a href="#message"><code>:message</code></a></li>
<li><a href="#on"><code>:on</code></a></li>
</ul>
</li>
<li><a href="#strict-validations">엄격한 유효성 검증</a></li>
<li>
<a href="#conditional-validation">조건부 유효성 검증</a>
<ul>
<li><a href="#using-a-symbol-with-if-and-unless">Using a Symbol with <code>:if</code> and <code>:unless</code></a></li>
<li><a href="#using-a-proc-with-if-and-unless">Using a Proc with <code>:if</code> and <code>:unless</code></a></li>
<li><a href="#grouping-conditional-validations">조건부 유효성 검증 그룹화하기</a></li>
<li><a href="#combining-validation-conditions">유효성 검증 조건 결합하기</a></li>
</ul>
</li>
<li>
<a href="#performing-custom-validations">사용자 정의 유효성 검증하기</a>
<ul>
<li><a href="#custom-validators">사용자 정의 유효성 검증 클래스</a></li>
<li><a href="#custom-method">사용자 정의 유효성 검증 메소드</a></li>
</ul>
</li>
<li>
<a href="#working-with-validation-errors">유효성 검증 에러 발생시 처리</a>
<ul>
<li><a href="#working-with-validation-errors-errors"><code>errors</code></a></li>
<li><a href="#errors"><code>errors[]</code></a></li>
<li><a href="#errors-add"><code>errors.add</code></a></li>
<li><a href="#working-with-validation-errors-errors-details"><code>errors.details</code></a></li>
<li><a href="#errors-base"><code>errors[:base]</code></a></li>
<li><a href="#errors-clear"><code>errors.clear</code></a></li>
<li><a href="#errors-size"><code>errors.size</code></a></li>
</ul>
</li>
<li><a href="#displaying-validation-errors-in-views">유효성 검증 에러를 뷰에 표시하기</a></li>
</ol>
</div>
</div>
</div>
<div id="container">
<div class="wrapper">
<div id="mainCol">
<h3 id="validations-overview"><a class="anchorlink" href="#validations-overview">1 유효성 검증 개요</a></h3><p>아래에 매우 간단한 유효성 검증 예가 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true
end
Person.create(name: "John Doe").valid? # => true
Person.create(name: nil).valid? # => false
</pre>
</div>
<p>보다시피, 위의 유효성 검증은 <code>Person</code>이 <code>name</code> 속성 없이는 유효하지 않다는 것을 알려 준다. 두 번째 <code>Person</code> 객체는 유효하지 않으므로 데이터베이스에 저장되지 않는다.</p><p>자세한 내용을 살펴보기 전에, 유효성 검증이 애플리케이션의 큰 그림에 어떻게 적용되는지에 대해 언급할 것이다.</p><h4 id="why-use-validations?"><a class="anchorlink" href="#why-use-validations?">1.1 유효성 검증을 사용하는 이유</a></h4><p>유효성 검증은 유효한 데이터만 데이터베이스에 저장되도록 하는데 사용된다. 예를 들어, 모든 사용자가 유효한 전자 메일 주소와 우편 주소를 제공하도록 하는 것이 애플리케이션에 중요할 수 있다. 모델에서의 유효성 검증은 유효한 데이터만 데이터베이스에 저장되도록 하는 가장 좋은 방법이다. 데이터베이스와 무관하며 최종 사용자가 피해 갈 수 없으며 테스트 및 유지 관리가 편리하다. 레일스는 사용하기 쉽고 일반적인 요구에 맞는 내장 헬퍼 메소드를 제공하며 자신만의 검증 메소드도 만들 수 있다.</p><p>네이티브 데이터베이스 제한 조건, 클라이언트 측 유효성 검증 및 컨트롤러 레벨 유효성 검증을 포함하여, 데이터베이스에 데이터를 저장하기 전에 데이터 유효성 검증하는 몇 가지 다른 방법이 있다. 장단점은 아래와 같다.</p>
<ul>
<li>데이터베이스 제약 조건 및 / 또는 저장 프로시저는 유효성 검사 메커니즘을 데이터베이스에 따라 달라지며 테스트 및 유지 관리를 더욱 어렵게 만들 수 있다. 그러나 다른 애플리케이션이 현재 애플리케이션이 사용 중인 데이터베이스를 사용하는 경우 데이터베이스 레벨에서 일부 제약 조건을 사용하는 것이 좋다. 또한 데이터베이스 레벨 유효성 검증은 다른 방법으로는 구현하기 어려운 부분(예 : 많이 사용되는 테이블의 유일성 검증)를 안전하게 처리 할 수 있다.</li>
<li>클라이언트측 유효성 검증은 유용 할 수 있지만 단독으로 사용하는 경우 일반적으로 신뢰할 수 없다. 자바스크립트를 사용하여 구현된 경우 사용자 브라우저에서 자바스크립트가 꺼져 있으면 아무런 소용이 없다. 그러나 다른 기술과 결합하면 클라이언트측 유효성 검증은 사용자가 웹사이트를 사용할 때 즉각적인 피드백을 제공하는 편리한 방법이 될 수 있다.</li>
<li>컨트롤러 레벨의 유효성 검증은 사용하기가 쉽지만 종종 다루기 어렵고 테스트 및 유지 관리가 어려워 진다. 가능할 때마다 컨트롤러를 스키니(skinny) 상태로 유지하는 것이 좋은데 장기적으로는 애플리케이션을 즐겁게 사용할 수 있기 해 주기 때문이다.</li>
</ul>
<p>특별한 경우에만 이러한 방법을 선택하기 바란다. 레일스 팀은 대부분의 상황에서 모델 수준의 검증이 가장 적합하다고 생각한다.</p><h4 id="when-does-validation-happen?"><a class="anchorlink" href="#when-does-validation-happen?">1.2 유효성 검증이 발생하는 시점</a></h4><p>데이터베이스내에의 레코드에 해당하는 객체와 그렇지 않은 객체, 두 가지 종류의 액티브 레코드 객체가 있다. 예를 들어 <code>new</code> 메소드를 사용하여 새로운 객체를 생성할 때 해당 객체는 아직 데이터베이스에 존재하지 않는다. 해당 객체에 대해 <code>save</code>를 호출하면 비로소 해당 데이터베이스 테이블에 저장된다. 액티브 레코드는<code>new_record?</code> 인스턴스 메소드를 사용하여 해당 객체가 이미 데이터베이스에 존재하는지 여부를 판단한다. 아래와 같은 간단한 액티브 레코드 클래스를 보면,</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
end
</pre>
</div>
<p><code>rails console</code> 출력을 보면 작동 방식을 확인할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
$ rails console
>> p = Person.new(name: "John Doe")
=> #<Person id: nil, name: "John Doe", created_at: nil, updated_at: nil>
>> p.new_record?
=> true
>> p.save
=> true
>> p.new_record?
=> false
</pre>
</div>
<p>새 레코드를 작성하고 저장하면 SQL <code>INSERT</code> 작업이 데이터베이스로 전송된다. 기존 레코드를 업데이트하면 대신 SQL <code>UPDATE</code> 작업이 전송된다. 유효성 검증은 일반적으로 이러한 명령이 데이터베이스로 전송되기 전에 실행된다. 유효성 검증에 실패하면 객체가 유효하지 않은 것으로 표시되고 액티브 레코드는 <code>INSERT</code> 또는 <code>UPDATE</code> 작업을 수행하지 않는다. 이로써 데이터베이스에 유효하지 않은 객체를 저장하지 않게 되는 것이다. 객체를 생성, 저장 또는 업데이트 할 때 특정 유효성 검증을 실행하도록 선택할 수 있다.</p><div class="warning"><p>데이터베이스에서 객체의 상태를 변경하는 방법은 여러 가지가 있다. 일부 메소드는 유효성 검증을 트리거하지만 일부 메소드는 그렇지 않다. 따라서, 조심하지 않으면 데이터베이스의 객체를 유효하지 않은 상태로 저장할 수 있다.</p></div><p>아래와 같은 메소드는 유효성 검증을 트리거하고 객체가 유효한 경우에만 데이터베이스에 저장한다.</p>
<ul>
<li><code>create</code></li>
<li><code>create!</code></li>
<li><code>save</code></li>
<li><code>save!</code></li>
<li><code>update</code></li>
<li><code>update!</code></li>
</ul>
<p>bang 버전 (예 : <code>save!</code>)은 레코드가 유효하지 않은 경우 예외를 발생시킨다. bang 이외의 버전은 그렇지 않다. 즉, <code>save</code>와 <code>update</code>는 데이터가 유효하지 않은 경우 <code>false</code>를 반환하고 <code>create</code>는 객체를 반환한다.</p><h4 id="skipping-validations"><a class="anchorlink" href="#skipping-validations">1.3 유효성 검증 피하기</a></h4><p>아래의 메소드는 유효성 검증을 하지 않기 때문에 유효성 여부에 관계없이 객체를 데이터베이스에 저장한다. 따라서 주의해서 사용해야 한다.</p>
<ul>
<li><code>decrement!</code></li>
<li><code>decrement_counter</code></li>
<li><code>increment!</code></li>
<li><code>increment_counter</code></li>
<li><code>toggle!</code></li>
<li><code>touch</code></li>
<li><code>update_all</code></li>
<li><code>update_attribute</code></li>
<li><code>update_column</code></li>
<li><code>update_columns</code></li>
<li><code>update_counters</code></li>
</ul>
<p><code>save</code>는 인수로 <code>validate: false</code>를 전달하면 유효성 검증 단계를 건너 뛸 수 있다. 이 방법은 주의해서 사용해야 한다.</p>
<ul>
<li><code>save(validate: false)</code></li>
</ul>
<h4 id="valid?-and-invalid?"><a class="anchorlink" href="#valid?-and-invalid?">1.4 <code>valid?</code>와 <code>invalid?</code> 메소드</a></h4><p>액티브 레코드 객체를 저장하기 전에 레일스는 유효성 검증을 실행한다. 이러한 유효성 검증으로 오류가 발생하면 레일스는 객체를 저장하지 않는다.</p><p>이러한 유효성 검증을 직접 실행할 수도 있다. <code>valid?</code>는 유효성 검증을 트리거하고 객체에 오류가 없으면 true를 반환하고 그렇지 않으면 false를 반환한다. 위에서 본 것처럼,</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true
end
Person.create(name: "John Doe").valid? # => true
Person.create(name: nil).valid? # => false
</pre>
</div>
<p>액티브 레코드가 유효성 검증을 수행 한 후 발견 된 에러는 에러 모음을 반환하는<code>errors.messages</code> 인스턴스 메소드를 통해 액세스 할 수 있다. 정의에 따르면 유효성 검증을 실행 한 후 이 콜렉션이 비어 있으면 객체가 유효한 것이다.</p><p><code>new</code> 메소드로 만들어진 객체는 기술적으로 유효하지 않더라도 에러를 보고하지 않는다. 왜냐하면 <code>create</code> 또는 <code>save</code> 메소드와 같이 객체가 저장되는 경우에만 유효성 검증이 자동으로 실행되기 때문이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true
end
>> p = Person.new
# => #<Person id: nil, name: nil>
>> p.errors.messages
# => {}
>> p.valid?
# => false
>> p.errors.messages
# => {name:["can't be blank"]}
>> p = Person.create
# => #<Person id: nil, name: nil>
>> p.errors.messages
# => {name:["can't be blank"]}
>> p.save
# => false
>> p.save!
# => ActiveRecord::RecordInvalid: Validation failed: Name can't be blank
>> Person.create!
# => ActiveRecord::RecordInvalid: Validation failed: Name can't be blank
</pre>
</div>
<p><code>invalid?</code>는 단순히 <code>valid?</code>의 반대되는 메소드다. 객체에서 에러가 발견되면 true를 반환하고 그렇지 않으면 false를 반환하는 방식으로 데이터의 유효성을 검증한다.</p><h4 id="validations-overview-errors"><a class="anchorlink" href="#validations-overview-errors">1.5 <code>errors[]</code></a></h4><p>객체의 특정 속성이 유효한지 확인하기 위해 <code>errors[:attribute]</code>를 사용할 수 있다. <code>:attribute</code>에 대한 모든 에러 배열을 반환한다. 지정된 속성에 에러가 없으면 빈 배열이 반환된다.</p><p>이 방법은 에러 컬렉션만 검사하고 유효성 검증 자체를 트리거하지 않기 때문에 유효성 검사가 실행된 <em>이후</em> 에만 유용하다. 객체의 유효성을 전체적으로 검증하지 않기 때문에 위에서 설명한 <code>ActiveRecord::Base#invalid?</code> 메소드와 다르다. 단지 객체의 개별 속성에 에러가 있는지 여부만 확인한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true
end
>> Person.new.errors[:name].any? # => false
>> Person.create.errors[:name].any? # => true
</pre>
</div>
<p><a href="#working-with-validation-errors">Working with Validation Errors</a> 섹션에서 유효성 검증 에러에 대해 자세히 설명한다.</p><h4 id="validations-overview-errors-details"><a class="anchorlink" href="#validations-overview-errors-details">1.6 <code>errors.details</code></a></h4><p>어떤 속성이 유효하지 않은 속성에서 실패했는지 확인하려면 <code>errors.details[:attribute]</code>를 사용하면 된다. 이것은 유효성 검사기의 심볼을 얻기 위해<code>:error</code> 키를 포함하는 해시 배열을 반환한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true
end
>> person = Person.new
>> person.valid?
>> person.errors.details[:name] # => [{error: :blank}]
</pre>
</div>
<p>사용자 지정 유효성 검사기에서 <code>details</code>를 사용하는 방법은 <a href="#working-with-validation-errors">Working with Validation Errors</a> 섹션에서 다룬다.</p><h3 id="validation-helpers"><a class="anchorlink" href="#validation-helpers">2 유효성 검증 헬퍼 메소드</a></h3><p>액티브 레코드는 클래스 정의 내에서 직접 사용할 수 있는 사전 정의 된 많은 검증 헬퍼를 제공한다. 이러한 헬퍼 메소드는 일반적인 유효성 검증 규칙을 제공한다. 유효성 검증이 실패 할 때마다 에러 메시지가 개체의 <code>errors</code> 컬렉션에 추가되고 이 메시지는 유효성이 검증되는 속성과 연관된다.</p><p>각 헬퍼 메소드는 다수의 속성 이름을 허용하므로 한 줄 코드로 여러 종류의 속성에 동일한 종류의 유효성 검증을 추가 할 수 있다.</p><p>이들 모두는 <code>:on</code> 및 <code>:message</code> 옵션을 허용하는데, 이 옵션은 유효성 검증을 언제 실행할지, 실패할 경우 에러 컬렉션에 어떤 메시지를 추가해야 하는지 정의한다. <code>:on</code> 옵션은 <code>:create</code> 또는 <code>:update</code> 값 중 하나를 사용한다. 유효성 검증 헬퍼 메소드 각각에 대한 기본 에러 메시지가 있다. 이 메시지는 <code>:message</code> 옵션이 지정되지 않은 경우에 사용된다. 사용 가능한 헬퍼 메소드 각각을 살펴 보도록 한다.</p><h4 id="acceptance"><a class="anchorlink" href="#acceptance">2.1 <code>acceptance</code></a></h4><p>이 메소드는 폼을 서밋할 때 사용자 인터페이스의 체크박스가 선택되었는지 확인한다. 일반적으로 사용자가 애플리케이션의 서비스 약관에 동의하거나 일부 텍스트를 읽었는지 또는 유사한 상황을 확인해야 할 때 사용된다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :terms_of_service, acceptance: true
end
</pre>
</div>
<p>이 검사는 <code>terms_of_service</code>가 <code>nil</code>이 아닌 경우에만 수행된다. 이 헬퍼 메소드의 기본 에러 메시지는 <em>"must be accepted"</em> 이다. <code>message</code> 옵션을 통해 사용자 정의 메시지를 전달할 수도 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :terms_of_service, acceptance: { message: 'must be abided' }
end
</pre>
</div>
<p>수락하는 것으로 간주될 값을 결정하는<code>:accept</code> 옵션도 지정할 수 있다. 기본값은 <code>['1 ', true]</code>이며 쉽게 변경할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :terms_of_service, acceptance: { accept: 'yes' }
validates :eula, acceptance: { accept: ['TRUE', 'accepted'] }
end
</pre>
</div>
<p>이 유효성 검증은 웹 애플리케이션에만 적용되며 이 '수락'은 데이터베이스의 어느 곳에나 기록할 필요가 없다. 해당 필드가 없으면 헬퍼 메소드는 가상 속성만 만들게 된다. 해당 필드가 데이터베이스에 존재하면 <code>accept</code> 옵션을 true로 설정하거나 포함해야 한다. 그렇지 않으면 유효성 검증이 실행되지 않는다.</p><h4 id="validates-associated"><a class="anchorlink" href="#validates-associated">2.2 <code>validates_associated</code></a></h4><p>모델이 다른 모델과 연관되어 있고 유효성을 검증해야하는 경우에는 이 헬퍼 메소드를 사용해야 한다. 그러면 객체를 저장할 때 연관된 객체 각각에 대해 <code>valid?</code> 메소드를 호출하게 된다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Library < ApplicationRecord
has_many :books
validates_associated :books
end
</pre>
</div>
<p>이 유효성 검증은 모든 연관 형태에서 작동한다.</p><div class="warning"><p>서로간에 연관이 정의된 모델 양쪽에 <code>validates_associated</code>를 사용하지 않도록 한다. 각 모델에서 서로를 호출하여 무한 루프에 빠지기 때문이다.</p></div><p><code>validates_associated</code>의 기본 에러 메시지는 <em>"is invalid"</em> 이다. 연결된 각 객체는 자체에 <code>errors</code> 컬렉션를 포함한다. 그러나 이 에러 컬렉션은 호출 모델에 영향을 미치지 않는다.</p><h4 id="confirmation"><a class="anchorlink" href="#confirmation">2.3 <code>confirmation</code></a></h4><p>정확히 동일한 내용을 수신해야하는 두 개의 텍스트 필드가있는 경우 이 헬퍼 메소드를 사용해야 한다. 이메일 주소나 비밀번호를 예로 들 수 있다. 이 유효성 검증은 확인되어야 하는 필드 이름 끝에 "_confirmation"이 추가된 가상 속성을 생성한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :email, confirmation: true
end
</pre>
</div>
<p>뷰 템플릿 파일에서는 아래와 같이 사용할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; html-script: true; gutter: false; toolbar: false">
<%= text_field :person, :email %>
<%= text_field :person, :email_confirmation %>
</pre>
</div>
<p>이것은 <code>email_confirmation</code>이 <code>nil</code>이 아닌 경우에만 수행된다. 확인을 요구하려면 확인 속성에 대한 존재 여부을 추가해야 한다 (이 안내서의 뒷부분에서 <code>presence</code> 옵션에 대해서 살펴 볼 것이다).</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :email, confirmation: true
validates :email_confirmation, presence: true
end
</pre>
</div>
<p>또한 <code>:case_sensitive</code> 옵션을 추가하면 확인 제약 조건이 대소 문자를 구분할지 여부를 정의하는 데 사용할 수 있다. 이 옵션의 기본값은 true이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :email, confirmation: { case_sensitive: false }
end
</pre>
</div>
<p>이 헬퍼 메소드의 기본 에러 메시지는 <em>"doesn't match confirmation"</em> 이다.</p><h4 id="exclusion"><a class="anchorlink" href="#exclusion">2.4 <code>exclusion</code></a></h4><p>이 헬퍼 메소드는 속성 값이 주어진 세트에 포함되지 않았는지 검증한다. 실제로 이 세트는 열거 가능한(enumerable) 객체일 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Account < ApplicationRecord
validates :subdomain, exclusion: { in: %w(www us ca jp),
message: "%{value} is reserved." }
end
</pre>
</div>
<p><code>exclusion</code> 헬퍼는 검증이 필요한 속성에 허용되지 않는 값들을 받는<code>:in</code> 옵션을 가지고 있다. <code>:in</code> 옵션에는 원한다면 같은 목적으로 사용할 수 있는<code>:within</code>이라는 별칭도 있다. 위의 예제는 <code>:message</code> 옵션을 사용하여 속성 값을 포함하는 방법을 보여 준다. 메시지 인수에 대한 전체 옵션은 <a href="#message">message documentation</a>를 참조한다.</p><p>기본 에러 메시지는 <em>"is reserved"</em> 이다.</p><h4 id="format"><a class="anchorlink" href="#format">2.5 <code>format</code></a></h4><p>이 헬퍼는 속성 값이 <code>:with</code> 옵션을 사용하여 지정한 정규 표현식과 일치하는지 테스트하여 속성 값의 유효성을 검증한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Product < ApplicationRecord
validates :legacy_code, format: { with: /\A[a-zA-Z]+\z/,
message: "only allows letters" }
end
</pre>
</div>
<p>또는 <code>:without</code> 옵션을 사용하여 지정된 속성이 정규 표현식과 일치하지 <em>않도록</em> 요구할 수 있다.</p><p>기본 에러 메시지는 <em>"is invalid"</em> 이다.</p><h4 id="inclusion"><a class="anchorlink" href="#inclusion">2.6 <code>inclusion</code></a></h4><p>이 헬퍼는 속성 값이 주어진 집합에 포함되어 있는지 확인합니다. 실제로 이 세트는 열거 가능한(enumerable) 객체일 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Coffee < ApplicationRecord
validates :size, inclusion: { in: %w(small medium large),
message: "%{value} is not a valid size" }
end
</pre>
</div>
<p><code>inclusion</code> 헬퍼에서는 <code>:in</code> 옵션을 사용하여 허용되는 값들을 지정할 수 있다. <code>:in</code> 옵션에는 원한다면 같은 목적으로 사용할 수 있는 <code>:within</code>이라는 별칭도 있다. 이전 예제는<code>:message</code> 옵션을 사용하여 속성 값을 포함하는 방법을 보여 준다. 전체 옵션은 <a href="#message">message documentation</a>를 참조한다.</p><p>이 헬퍼의 기본 에러 메시지는 <em>"is not included in the list"</em> 이다.</p><h4 id="length"><a class="anchorlink" href="#length">2.7 <code>length</code></a></h4><p>이 헬퍼는 속성 값의 길이를 검사한다. 다양한 옵션을 제공하므로 여러가지 방법으로 길이 제한을 지정할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, length: { minimum: 2 }
validates :bio, length: { maximum: 500 }
validates :password, length: { in: 6..20 }
validates :registration_number, length: { is: 6 }
end
</pre>
</div>
<p>사용 가능한 길이 제한 옵션은 아래와 같다. </p>
<ul>
<li>
<code>:minimum</code> - 해당 속성은 지정된 길이보다 작을 수 없다.</li>
<li>
<code>:maximum</code> - 해당 속성은 지정된 길이보다 길 수 없다.</li>
<li>
<code>:in</code> (or <code>:within</code>) - 해당 속성의 길이는 주어진 구간에 포함되어야 한다. 이 옵션의 값은 range 형이어야 한다.</li>
<li>
<code>:is</code> - 해당 속성 길이는 주어진 값과 같아야 한다.</li>
</ul>
<p>기본 에러 메시지는 사용하는 길이 유효성 검증 형태에 따라 다르다. <code>:wrong_length</code>, <code>:too_long</code>, <code>:too_short</code> 옵션과 사용 중인 길이 제한 조건에 해당하는 숫자의 placeholder로 사용하는 <code>%{count}</code>를 사용하여 이러한 메시지를 개인화할 수 있다. 여전히 <code>:message</code> 옵션을 사용하여 에러 메시지를 지정할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :bio, length: { maximum: 1000,
too_long: "%{count} characters is the maximum allowed" }
end
</pre>
</div>
<p>기본 에러 메시지는 복수형(예 : "is too short (minimum is %{count} characters)")이라는 것에 주의한다. 이러한 이유로 <code>:minimum</code>이 1 인 경우 사용자 지정 메시지를 제공하거나 <code>presence: true</code>를 대신 사용해야 한다. <code>:in</code> 또는 <code>:within</code>의 하한이 1 인 경우, 사용자 지정 메시지를 제공하거나 <code>length</code> 이전에 <code>presence</code>를 호출해야 한다.</p><h4 id="numericality"><a class="anchorlink" href="#numericality">2.8 <code>numericality</code></a></h4><p>이 헬퍼 메소드는 속성에 숫자 값만 있는지 확인한다. 기본적으로 추가로 지정할 수 있는 부호와 이후의 정수 또는 부동 소수점 숫자가 일치하는지 검사할 것이다. 정수만 허용하도록 지정하려면 <code>:only_integer</code>를 true로 설정한다.</p><p><code>:only_integer</code>를 true로 지정하면 아래와 같은 정규표현식을 사용하여</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
/\A[+-]?\d+\z/
</pre>
</div>
<p>속성 값을 검사할 것이다. 그렇지 않을 경우 속성 값을 <code>Float</code>를 사용하여 실수로 변환할 것이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Player < ApplicationRecord
validates :points, numericality: true
validates :games_played, numericality: { only_integer: true }
end
</pre>
</div>
<p><code>:only_integer</code> 외에도 아래의 옵션을 사용하여 속성 값에 제약 조건을 추가한다.</p>
<ul>
<li>
<code>:greater_than</code> - 속성 값이 특정 값보다 커야 함을 지정한다. 이 옵션의 기본 에러 메시지는 <em>"must must be greater than %{count}"</em> 이다.</li>
<li>
<code>:greater_than_or_equal_to</code> - 속성 값이 특정 값보다 크거나 같아야 함을 지정한다. 이 옵션의 기본 에러 메시지는 <em>"must be greater than or equal to %{count}"</em> 이다.</li>
<li>
<code>:equal_to</code> - 속성 값이 특정 값과 같아야 함을 지정한다. 이 옵션의 기본 에러 메시지는 <em>"must be equal to %{count}"</em> 이다.</li>
<li>
<code>:less_than</code> - 속성 값이 특정 값보다 작아야 함을 지정한다. 이 옵션의 기본 에러 메시지는 <em>"must be less than %{count}"</em> 이다.</li>
<li>
<code>:less_than_or_equal_to</code> - 속성 값이 특정 값보다 작거나 같아야 함을 지정한다. 이 옵션의 기본 에러 메시지는 <em>"must be less than or equal to %{count}"</em> 이다.</li>
<li>
<code>:other_than</code> - 속성 값이 특정 값 이외의 값이어야 한다. 이 옵션의 기본 애로 메시지는 <em>"must be other than %{count}"</em> 이다.</li>
<li>
<code>:odd</code> - 속성 값이 true로 설정되면 값이 홀수이어야 한다. 이 옵션의 기본 에러 메시지는 _ <em>"must be odd"</em> 이다.</li>
<li>
<code>:even</code> - 속성 값이 true로 설정되면 값이 짝수이어야 한다. 이 옵션의 기본 에러 메시지는 <em>"must be even"</em> 이다.</li>
</ul>
<div class="note"><p>기본적으로 <code>numericality</code>는 <code>nil</code> 값을 허용하지 않는다. 그러나, <code>allow_nil: true</code> 옵션을 사용하면 허용할 수 있다.</p></div><p>기본 에러 메시지는 <em>"is not a number"</em> 이다.</p><h4 id="presence"><a class="anchorlink" href="#presence">2.9 <code>presence</code></a></h4><p>이 헬퍼는 지정된 속성이 비어 있지 않은지 확인한다. <code>blank?</code> 메소드를 사용하여 값이 <code>nil</code> 인지 또는 빈 문자열인지, 즉 비어 있거나 공백으로 구성된 문자열인지 확인한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, :login, :email, presence: true
end
</pre>
</div>
<p>모델간의 관계가 정의되어 있는지 확인하려면 관계 설정에 사용하는 외래 키가 아니라 관련 객체 자체가 있는지 테스트해야 한다. 이런 식으로 외래 키가 비어 있지 않을 뿐만 아니라 참조 된 객체가 존재하는지 확인한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class LineItem < ApplicationRecord
belongs_to :order
validates :order, presence: true
end
</pre>
</div>
<p>반드시 존재해야 하는 연관 레코드의 유효성을 검증하려면 해당 관계 정의에 대해<code>:inverse_of</code> 옵션을 지정해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Order < ApplicationRecord
has_many :line_items, inverse_of: :order
end
</pre>
</div>
<p><code>has_one</code> 또는 <code>has_many</code> 관계를 통해 연관된 객체가 있는지 검증할 경우에는 해당 객체가 <code>blank?</code> 또는 <code>marked_for_destruction?</code>이 아닌지 확인한다.</p><p><code>false.blank?</code>가 true 값을 반환하기 때문에 논리값 데이터형을 가지는 필드의 존재를 검증하려면 아래의 검증 중 하나를 사용해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
validates :boolean_field_name, inclusion: { in: [true, false] }
validates :boolean_field_name, exclusion: { in: [nil] }
</pre>
</div>
<p>이러한 유효성 검사 중 하나를 사용하면, 속성 값이 대부분의 경우 <code>NULL</code> 값을 가지는 <code>nil</code>이 <strong>아님</strong>을 확인한다.</p><h4 id="absence"><a class="anchorlink" href="#absence">2.10 <code>absence</code></a></h4><p>이 헬퍼는 지정된 속성이 존재하지 않음을 검증한다. <code>present?</code> 메소드를 사용하여 값이 nil이 아니거나 빈 문자열, 즉 비어 있거나 공백으로 구성된 문자열이 아닌지 확인한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, :login, :email, absence: true
end
</pre>
</div>
<p>모델간의 관계 정의가 존재하지 않음을 확인하려면, 관계 정의에 사용하는 외래 키가 아니라 관련 객체 자체가 존재하지 않음을 테스트해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class LineItem < ApplicationRecord
belongs_to :order
validates :order, absence: true
end
</pre>
</div>
<p>존재해서는 안되는 연관 레코드의 유효성을 검증하려면 관계 정의에 <code>:inverse_of</code> 옵션을 지정해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Order < ApplicationRecord
has_many :line_items, inverse_of: :order
end
</pre>
</div>
<p><code>has_one</code> 또는 <code>has_many</code> 모델 관계를 통해 연관된 객체가 존재하지 않는 것을 검증하면 해당 객체가 <code>present?</code> 가 아니거나 <code>marked_for_destruction?</code>이 아님을 확인하게 된다.</p><p><code>false.present?</code>가 false이므로 논리값을 가지는 필드가 존재하지 않음을 확인하려면<code>validates :field_name, exclusion: {in: [true, false]}</code>를 사용해야 한다.</p><p>기본 에러 메시지는 <em>"must be blank"</em> 이다.</p><h4 id="uniqueness"><a class="anchorlink" href="#uniqueness">2.11 <code>uniqueness</code></a></h4><p>이 헬퍼는 객체가 저장되기 직전에 유일한 속성값을 가지는지 확인한다. 데이터베이스에서 유일성 제한 조건을 작성하지 않으므로 서로 다른 두 개의 데이터베이스 연결이 유일한 값을 가져야 하는 특정 컬럼에 대해 동일한 값을 가지는 두 개의 레코드를 작성할 수 있게 된다. 따라서 이를 피하려면 데이터베이스의 해당 레코드에 유일한 인덱스를 작성해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Account < ApplicationRecord
validates :email, uniqueness: true
end
</pre>
</div>
<p>해당 속성에서 동일한 값을 가진 기존 레코드를 검색하기 위해 모델 테이블에 대한 SQL 쿼리를 시행하므로써 유효성 검증이 발생하게 된다.</p><p><code>:scope</code> 옵션을 이용하면 유일성 검사를 제한하는 데 사용되는 하나 이상의 속성을 지정할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Holiday < ApplicationRecord
validates :name, uniqueness: { scope: :year,
message: "should happen once per year" }
end
</pre>
</div>
<p><code>:scope</code> 옵션을 사용하여 유일성 검증의 위반 방지를 위해 데이터베이스 제한 조건을 작성하려면 데이터베이스의 두 컬럼 모두에 유일한 색인을 작성해야 한다. 다중 컬럼 인덱스에 대한 자세한 내용은 <a href="https://dev.mysql.com/doc/refman/5.7/en/multiple-column-indexes.html">the MySQL manual</a>을 참조하거나 컬럼 그룹을 참조하는 유일성 제한 조건의 예는 <a href="https://www.postgresql.org/docs/current/static/ddl-constraints.html">the PostgreSQL manual</a>을 참조한다.</p><p><code>:case_sensitive</code> 옵션을 이용하면, 유일성 제약 조건이 대소 문자를 구분하는지 여부를 정의하는 데 사용할 수 있다. 이 옵션의 기본값은 true이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, uniqueness: { case_sensitive: false }
end
</pre>
</div>
<div class="warning"><p>일부 데이터베이스는 대소 문자를 구분하지 않는 검색을 수행하도록 설정되어 있다는 것에 주의한다.</p></div><p>기본 에러 메시지는 <em>"has already been taken"</em> 이다.</p><h4 id="validates-with"><a class="anchorlink" href="#validates-with">2.12 <code>validates_with</code></a></h4><p>이 헬퍼는 유효성 검증을 위해 별도의 클래스로 레코드를 전달한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class GoodnessValidator < ActiveModel::Validator
def validate(record)
if record.first_name == "Evil"
record.errors[:base] << "This person is evil"
end
end
end
class Person < ApplicationRecord
validates_with GoodnessValidator
end
</pre>
</div>
<div class="note"><p><code>record.errors[:base]</code>에 추가 된 에러는 특정 속성이 아니라 레코드의 전체 상태와 관련이 있다.</p></div><p><code>validates_with</code> 헬퍼는 하나의 클래스 또는 클래스 목록을 취해서 유효성 검증에 사용한다. <code>validates_with</code>에 대한 기본 에러 메시지는 없다. 유효성 검증기 클래스의 레코드 에러 콜렉션에 수동으로 에러를 추가해야 한다.</p><p><code>validate</code> 메소드를 구현하려면 검증 할 레코드인 <code>record</code> 매개 변수가 정의되어 있어야 한다.</p><p>다른 모든 유효성 검증과 마찬가지로 <code>validates_with</code>는 <code>:if</code>, <code>:unless</code> 및<code>:on</code> 옵션을 사용한다. 다른 옵션을 전달하면 해당 옵션을 유효성 검증 클래스에 <code>options</code>로 보낸다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class GoodnessValidator < ActiveModel::Validator
def validate(record)
if options[:fields].any?{|field| record.send(field) == "Evil" }
record.errors[:base] << "This person is evil"
end
end
end
class Person < ApplicationRecord
validates_with GoodnessValidator, fields: [:first_name, :last_name]
end
</pre>
</div>
<p>유효성 검증 클래스는 매 유효성 검증 실행마다가 아닌 전체 애플리케이션 수명주기 동안 <em>단 한 번만</em> 초기화되므로 내부에서 인스턴스 변수를 사용하는 데 주의해야 한다.</p><p>유효성 검증 클래스가 인스턴스 변수를 원할 정도로 복잡하다면 대신 <strong>PORO</strong>(Plain Old Ruby Object, 상속 받지 않는 단순 루비 객체, 譯註)를 손쉽게 사용할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validate do |person|
GoodnessValidator.new(person).validate
end
end
class GoodnessValidator
def initialize(person)
@person = person
end
def validate
if some_complex_condition_involving_ivars_and_private_methods?
@person.errors[:base] << "This person is evil"
end
end
# ...
end
</pre>
</div>
<h4 id="validates-each"><a class="anchorlink" href="#validates-each">2.13 <code>validates_each</code></a></h4><p>이 헬퍼는 블록으로 넘겨 준 속성에 대해서 유효성을 검증한다. 사전 정의된 유효성 검증 기능은 없다. 블록을 사용하여 검증 기능을 작성해야 하며, <code>validates_each</code>에 전달된 모든 속성에 대해서 유효성을 검증하게 된다. 아래의 예에서는 이름과 성이 대문자로 시작하는지 검증한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates_each :name, :surname do |record, attr, value|
record.errors.add(attr, 'must start with upper case') if value =~ /\A[[:lower:]]/
end
end
</pre>
</div>
<p>블록은 레코드, 속성 이름 및 속성 값을 넘겨 받는다. 블록 내에서 유효한 데이터를 확인하려는 모든 작업을 수행 할 수 있다. 유효성 검증에 실패하면 모델에 에러 메시지를 추가하여 데이터가 유효하지 않게 된다.</p><h3 id="common-validation-options"><a class="anchorlink" href="#common-validation-options">3 일반적인 유효성 검증 옵션</a></h3><p>아래는 일반적인 유효성 검사 옵션들이다.</p><h4 id="allow-nil"><a class="anchorlink" href="#allow-nil">3.1 <code>:allow_nil</code></a></h4><p><code>:allow_nil</code> 옵션은 검증되는 값이 <code>nil</code>인 경우 검증을 건너 뛴다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Coffee < ApplicationRecord
validates :size, inclusion: { in: %w(small medium large),
message: "%{value} is not a valid size" }, allow_nil: true
end
</pre>
</div>
<p>메시지 인수에 대한 전체 옵션은 <a href="#message">message documentation</a>를 참조한다.</p><h4 id="allow-blank"><a class="anchorlink" href="#allow-blank">3.2 <code>:allow_blank</code></a></h4><p><code>:allow_blank</code> 옵션은<code>:allow_nil</code> 옵션과 유사하다. 이 옵션은 속성 값이<code>nil</code> 또는 빈 문자열과 같은 <code>blank?</code>인 경우 유효성 검증을 통과시킨다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Topic < ApplicationRecord
validates :title, length: { is: 5 }, allow_blank: true
end
Topic.create(title: "").valid? # => true
Topic.create(title: nil).valid? # => true
</pre>
</div>
<h4 id="message"><a class="anchorlink" href="#message">3.3 <code>:message</code></a></h4><p>앞에서 본 것처럼 <code>:message</code> 옵션을 사용하면 유효성 검증에 실패할 때 <code>errors</code> 컬렉션에 추가될 메시지를 지정할 수 있다. 이 옵션을 사용하지 않으면 액티브 레코드는 각 유효성 검증 헬퍼에 대해 각각의 기본 에러 메시지를 사용한다. <code>:message</code> 옵션에 <code>String</code> 또는 <code>Proc</code>를 사용할 수 있다.</p><p><code>String</code> <code>:message</code> 값은 <code>%{value}</code>, <code>%{attribute}</code>, <code>%{model}</code> 중 일부 또는 전부를 선택적으로 포함할 수 있으며, 유효성 검증에 실패하면 동적으로 대체된다. 이것은 I18n 젬을 사용하여 수행되며 placeholder는 정확히 일치해야 하고 공백은 허용되지 않는다.</p><p><code>Proc</code> <code>:message</code> 값에는 두 개의 인수, 즉 검증되는 객체와, <code>:model</code>, <code>:attribute</code>, <code>:value</code> 세 개의 키-값 쌍이 있는, 해시가 제공된다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
# 하드 코딩된 메시지
validates :name, presence: { message: "must be given please" }
# 동적 속성 값을 포함하는 메시지.
# %{value}는 속성의 실제 값으로 대체된다.
# %{attribute}, %{model}도 사용 가능하다.
validates :age, numericality: { message: "%{value} seems wrong" }
# Proc
validates :username,
uniqueness: {
# object = person object being validated
# data = { model: "Person", attribute: "Username", value: <username> }
message: ->(object, data) do
"Hey #{object.name}!, #{data[:value]} is taken already! Try again #{Time.zone.tomorrow}"
end
}
end
</pre>
</div>
<h4 id="on"><a class="anchorlink" href="#on">3.4 <code>:on</code></a></h4><p><code>:on</code> 옵션을 사용하면 유효성 검증 시기를 지정할 수 있다. 내장된 모든 유효성 검증 헬퍼의 기본 동작은 저장시(새 레코드를 만들 때와 업데이트 할 때) 실행된다. 변경하려면 <code>on: :create</code>를 사용하여 새 레코드가 생성될 때만 유효성 검증을 실행하거나 <code>on: :update</code>를 사용하여 레코드가 업데이트될 때만 유효성 검증을 실행할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
# 이메일을 중복된 값으로 업데이트(update) 할 수 있다.
validates :email, uniqueness: true, on: :create
# 레코드를 생성(create)할 때는 연령 값이 숫자가 아니어도 된다.
validates :age, numericality: true, on: :update
# 기본 상태 (create, update 모두에서 유효성을 검증한다.)
validates :name, presence: true
end
</pre>
</div>
<p><code>on:</code>을 사용하여 사용자 정의 컨텍스트를 정의할 수 도 있다. 컨텍스트 이름을 <code>valid?</code>, <code>invalid?</code> 또는 <code>save</code>에 전달하여 사용자 정의 컨텍스트를 명시적으로 트리거해야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :email, uniqueness: true, on: :account_setup
validates :age, numericality: true, on: :account_setup
end
person = Person.new(age: 'thirty-three')
person.valid? # => true
person.valid?(:account_setup) # => false
person.errors.messages
# => {:email=>["has already been taken"], :age=>["is not a number"]}
</pre>
</div>
<p><code>person.valid?(:account_setup)</code>은 모델을 저장하지 않고 두 가지 유효성 검증을 모두 실행한다. <code>person.save(context: :account_setup)</code>은 저장하기 전에 <code>account_setup</code> 컨텍스트에서 <code>person</code>을 검증한다.</p><p>명시적 컨텍스트에 의해 유효성 검증이 트리거되면 해당 컨텍스트에 대한 유효성 검증과 컨텍스트가 없는 상태의 유효성 검증이 실행된다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :email, uniqueness: true, on: :account_setup
validates :age, numericality: true, on: :account_setup
validates :name, presence: true
end
person = Person.new
person.valid?(:account_setup) # => false
person.errors.messages
# => {:email=>["has already been taken"], :age=>["is not a number"], :name=>["can't be blank"]}
</pre>
</div>
<h3 id="strict-validations"><a class="anchorlink" href="#strict-validations">4 엄격한 유효성 검증</a></h3><p>유효성 검증을 엄격하게 지정하면 해당 객체가 유효하지 않은 경우 <code>ActiveModel::StrictValidationFailed</code>를 발생시킬 수도 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: { strict: true }
end
Person.new.valid? # => ActiveModel::StrictValidationFailed: Name can't be blank
</pre>
</div>
<p><code>:strict</code> 옵션에 사용자 정의 예외를 전달하는 기능도 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :token, presence: true, uniqueness: true, strict: TokenGenerationException
end
Person.new.valid? # => TokenGenerationException: Token can't be blank
</pre>
</div>
<h3 id="conditional-validation"><a class="anchorlink" href="#conditional-validation">5 조건부 유효성 검증</a></h3><p>때로는 해당 predicate 메소드(true/false를 반환하는 메소드)가 만족될 때만 특정 객체에 대한 유효성 검증을 하는 것이 타당할 경우도 있을 것이다. <code>:if</code> 와 <code>:unless</code> 옵션에 심볼, <code>Proc</code> 또는 <code>Array</code>를 지정하여 이를 수행할 수 있다. 유효성 검증이 발생<strong>해야</strong> 하는 시기를 지정할 경우 <code>:if</code> 옵션을 사용할 수 있다. 유효성 검증이 발생하지 <strong>않아야 하는</strong> 시기를 지정할 경우 <code>:unless</code> 옵션을 사용할 수 있다.</p><h4 id="using-a-symbol-with-if-and-unless"><a class="anchorlink" href="#using-a-symbol-with-if-and-unless">5.1 Using a Symbol with <code>:if</code> and <code>:unless</code></a></h4><p><code>:if</code> 및 <code>:unless</code> 옵션을 유효성 검증이 발생하기 직전에 호출될 메소드 이름에 해당하는 심볼과 연결할 수 있다. 가장 일반적으로 사용되는 옵션이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Order < ApplicationRecord
validates :card_number, presence: true, if: :paid_with_card?
def paid_with_card?
payment_type == "card"
end
end
</pre>
</div>
<h4 id="using-a-proc-with-if-and-unless"><a class="anchorlink" href="#using-a-proc-with-if-and-unless">5.2 Using a Proc with <code>:if</code> and <code>:unless</code></a></h4><p><code>:if</code> 와 <code>:unless</code> 옵션을 호출될 <code>Proc</code> 객체와 연관시킬 수도 있다. <code>Proc</code> 객체를 사용하면 별도의 메소드 대신 인라인 조건을 작성할 수 있다. 이 옵션은 한줄 코딩에 가장 적합하다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Account < ApplicationRecord
validates :password, confirmation: true,
unless: Proc.new { |a| a.password.blank? }
end
</pre>
</div>
<p><code>람다(Lambda)</code>는 <code>Proc</code>의 한 유형이므로 인라인 조건을 더 짧은 방식으로 작성하는 데에도 사용할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
validates :password, confirmation: true, unless: -> { password.blank? }
</pre>
</div>
<h4 id="grouping-conditional-validations"><a class="anchorlink" href="#grouping-conditional-validations">5.3 조건부 유효성 검증 그룹화하기</a></h4><p>여러 검증에서 하나의 조건을 사용하는 것이 유용한 경우도 있다. <code>with_options</code>를 사용하면 쉽게 구현할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class User < ApplicationRecord
with_options if: :is_admin? do |admin|
admin.validates :password, length: { minimum: 10 }
admin.validates :email, presence: true
end
end
</pre>
</div>
<p><code>with_options</code> 블록 안의 모든 유효성 검사는 자동으로 <code>if: :is_admin?</code> 조건을 만족한 상태가 될 것이다.</p><h4 id="combining-validation-conditions"><a class="anchorlink" href="#combining-validation-conditions">5.4 유효성 검증 조건 결합하기</a></h4><p>반면, 여러 조건이 결합하여 유효성 검증 수행 여부를 결정할 때 <code>배열</code>을 사용할 수 있다. 또한 동일한 유효성 검증에 <code>:if</code> 와 <code>:unless</code>를 둘 다 적용 할 수 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Computer < ApplicationRecord
validates :mouse, presence: true,
if: [Proc.new { |c| c.market.retail? }, :desktop?],
unless: Proc.new { |c| c.trackpad.present? }
end
</pre>
</div>
<p>유효성 검증은 모든 <code>:if</code> 조건이 <code>true</code>로 평가되고 모든 <code>:unless</code> 조건이 <code>false</code>로 평가되는 경우에만 실행된다.</p><h3 id="performing-custom-validations"><a class="anchorlink" href="#performing-custom-validations">6 사용자 정의 유효성 검증하기</a></h3><p>내장된 유효성 검증 헬퍼가 충분하지 않은 경우 직접 유효성 검증 클래스 또는 유효성 검증 메소드를 작성할 수 있다.</p><h4 id="custom-validators"><a class="anchorlink" href="#custom-validators">6.1 사용자 정의 유효성 검증 클래스</a></h4><p>사용자 정의 유효성 검증 클래스는 <code>ActiveModel::Validator</code>에서 상속된다. 이 클래스는 레코드를 인수로 사용하며 유효성을 검증하는 <code>validate</code> 메소드를 구현해야 한다. 커스텀 유효성 검증 클래스는 <code>validates_with</code> 메소드를 사용하여 호출한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class MyValidator < ActiveModel::Validator
def validate(record)
unless record.name.starts_with? 'X'
record.errors[:name] << 'Need a name starting with X please!'
end
end
end
class Person
include ActiveModel::Validations
validates_with MyValidator
end
</pre>
</div>
<p>개별 속성을 검증하기 위해 사용자 정의 유효성 검증 클래스를 추가하는 가장 쉬운 방법은 편리한 <code>ActiveModel::EachValidator</code>를 상속받아 사용하는 것이다. 이 경우 사용자 정의 유효성 검증 클래스는 레코드, 속성, 값의 세 가지 인수를 사용하는 <code>validate_each</code> 메서드를 구현해야 한다. 이들은 각각 인스턴스, 유효성을 검증할 속성, 전달된 인스턴스 내의 속성 값에 해당한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class EmailValidator < ActiveModel::EachValidator
def validate_each(record, attribute, value)
unless value =~ /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i
record.errors[attribute] << (options[:message] || "is not an email")
end
end
end
class Person < ApplicationRecord
validates :email, presence: true, email: true
end
</pre>
</div>
<p>예제에 표시된 것처럼 표준 유효성 검증을 사용자 정의 유효성 검증 클래스와 결합 할 수도 있다.</p><h4 id="custom-method"><a class="anchorlink" href="#custom-method">6.2 사용자 정의 유효성 검증 메소드</a></h4><p>모델의 상태를 확인하는 메소드를 작성하여 유효하지 않은 경우 에러 컬렉션에 메시지를 추가할 수도 있다. 그런 다음 <code>validate</code> (<a href="https://api.rubyonrails.org/6-0-stable/classes/ActiveModel/Validations/ClassMethods.html#method-i-validate">API</a>) 클래스 메소드를 사용하여 유효성 검증 메소드명을 심볼로 등록해야 한다.</p><p>각 클래스 메소드에 대해 둘 이상의 심볼을 전달할 수 있으며 각 유효성 검증 메소드는 등록된 순서대로 실행된다.</p><p><code>valid?</code> 메소드는 에러 컬렉션이 비어 있는지 확인하므로 사용자 정의 유효성 검증 메소드는 유효성 검증에 실패할 때 에러를 추가해 주어야 한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Invoice < ApplicationRecord
validate :expiration_date_cannot_be_in_the_past,
:discount_cannot_be_greater_than_total_value
def expiration_date_cannot_be_in_the_past
if expiration_date.present? && expiration_date < Date.today
errors.add(:expiration_date, "can't be in the past")
end
end
def discount_cannot_be_greater_than_total_value
if discount > total_value
errors.add(:discount, "can't be greater than total value")
end
end
end
</pre>
</div>
<p>기본적으로 이러한 유효성 검사는 'valid?'를 호출하거나 객체를 저장할 때마다 실행된다. 그러나 <code>:create</code> 또는 <code>:update</code>와 함께 <code>validate</code> 메소드에 <code>:on</code> 옵션을 제공하여 이러한 사용자 지정 유효성 검증을 실행할 시기를 제어 할 수도 있다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Invoice < ApplicationRecord
validate :active_customer, on: :create
def active_customer
errors.add(:customer_id, "is not active") unless customer.active?
end
end
</pre>
</div>
<h3 id="working-with-validation-errors"><a class="anchorlink" href="#working-with-validation-errors">7 유효성 검증 에러 발생시 처리</a></h3><p>레일스는 앞에서 설명한 <code>valid?</code> 와 <code>invalid?</code> 메소드 외에도 <code>errors</code> 컬렉션을 처리하는 메소드와 객체의 유효성을 검증하는 여러가지 메소드를 함께 제공한다.</p><p>아래는 가장 일반적으로 사용되는 메소드의 목록이다. 사용 가능한 모든 메소드 목록은 <code>ActiveModel::Errors</code> 문서를 참조한다.</p><h4 id="working-with-validation-errors-errors"><a class="anchorlink" href="#working-with-validation-errors-errors">7.1 <code>errors</code></a></h4><p>이것은 모든 에러를 포함하는 <code>ActiveModel::Errors</code> 클래스의 인스턴스를 반환한다. 각 키는 속성 이름이고 값은 모든 에러를 포함하는 문자열 배열이다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true, length: { minimum: 3 }
end
person = Person.new
person.valid? # => false
person.errors.messages
# => {:name=>["can't be blank", "is too short (minimum is 3 characters)"]}
person = Person.new(name: "John Doe")
person.valid? # => true
person.errors.messages # => {}
</pre>
</div>
<h4 id="errors"><a class="anchorlink" href="#errors">7.2 <code>errors[]</code></a></h4><p><code>errors[]</code>는 특정 속성에 대한 에러 메시지를 확인하려고 할 때 사용한다. 주어진 속성에 대한 모든 에러 메시지가 포함된 문자열 배열을 반환하며 각 문자열은 하나의 에러 메시지에 해당한다. 속성과 관련된 에러가 없으면 빈 배열을 반환한다.</p><div class="code_container">
<pre class="brush: ruby; gutter: false; toolbar: false">
class Person < ApplicationRecord
validates :name, presence: true, length: { minimum: 3 }
end
person = Person.new(name: "John Doe")
person.valid? # => true
person.errors[:name] # => []
person = Person.new(name: "JD")
person.valid? # => false
person.errors[:name] # => ["is too short (minimum is 3 characters)"]
person = Person.new
person.valid? # => false
person.errors[:name]
# => ["can't be blank", "is too short (minimum is 3 characters)"]